Clusters - Update

Referência

Serviço:: Log Analytics

Versão da API:: 2023-09-01

Atualizações um cluster do Log Analytics.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version=2023-09-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
clusterName	path	True	string	Nome do Cluster do Log Analytics.
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string	A ID da assinatura de destino.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
identity	ManagedServiceIdentity	Identidade do recurso.
properties.billingType	BillingType	O tipo de cobrança do cluster.
properties.keyVaultProperties	keyVaultProperties	As propriedades de chave associadas.
sku	ClusterSku	As propriedades de sku.
tags	object	Marcas de recurso.

Respostas

Nome	Tipo	Description
200 OK	Cluster	O cluster existente foi atualizado com êxito. Verifique provisioningStatus para ver status detalhadas.
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

ClustersPatch

Solicitação de exemplo

HTTP

PATCH https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685?api-version=2023-09-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myidentity": {}
    }
  },
  "properties": {
    "keyVaultProperties": {
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyName": "aztest2170cert",
      "keyVersion": "",
      "keyRsaSize": 1024
    }
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "tags": {
    "tag1": "val1"
  }
}

Resposta de exemplo

Código de status:: 200

{
  "identity": {
    "type": "UserAssigned",
    "tenantId": "72f999bf-acf1-41af-91ab-2d7cd011db47",
    "userAssignedIdentities": {
      "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myidentity": {
        "clientId": "eb3a943d-6b12-48a6-b585-ac2316e15ab2",
        "principalId": "b31776d4-ee80-4860-9433-ec0101be1891"
      }
    }
  },
  "properties": {
    "keyVaultProperties": {
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyName": "aztest2170cert",
      "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
    },
    "provisioningState": "Succeeded",
    "clusterId": "1c3f2afc-9ec1-4e74-bfe8-022b83bcd7b1",
    "billingType": "Cluster",
    "lastModifiedDate": "Sun, 04 Jan 2020 17:10:56 GMT",
    "createdDate": "Mon, 13 Jan 2020 14:40:33 GMT",
    "associatedWorkspaces": [
      {
        "workspaceId": "942bdefd-e6c9-411c-ac69-70ffad564363",
        "workspaceName": "testWs1",
        "resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs1",
        "associateDate": "Tue, 07 Jul 2020 07:35:51 GMT"
      },
      {
        "workspaceId": "c7edb8f8-67f7-41f2-bddb-aecf22507e3f",
        "workspaceName": "testWs2",
        "resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs2",
        "associateDate": "Mon, 13 Jan 2020 16:03:39 GMT"
      }
    ],
    "capacityReservationProperties": {
      "lastSkuUpdate": "Thu, 01 Jan 1970 00:00:00 GMT",
      "minCapacity": 100
    }
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "name": "oiautorest6685",
  "type": "Microsoft.OperationalInsights/clusters",
  "id": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685"
}

Definições

Nome	Description
AssociatedWorkspace	A lista de workspaces do Log Analytics associados ao cluster.
BillingType	O tipo de cobrança do cluster.
Capacity	O nível de reserva de capacidade em Gigabytes para esse cluster.
CapacityReservationProperties	As propriedades de Reserva de Capacidade.
Cluster	O contêiner de recursos de cluster do Log Analytics de nível superior.
ClusterEntityStatus	O estado de provisionamento do cluster.
ClusterPatch	O contêiner de recursos de cluster do Log Analytics de nível superior.
ClusterSku	A definição de sku do cluster.
ClusterSkuNameEnum	A SKU (camada) de um cluster.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
keyVaultProperties	As propriedades do cofre de chaves.
ManagedServiceIdentity	Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou atribuídas pelo usuário)
ManagedServiceIdentityType	Tipo de identidade de serviço gerenciada (em que os tipos SystemAssigned e UserAssigned são permitidos).
UserAssignedIdentity	Propriedades de identidade atribuídas pelo usuário

AssociatedWorkspace

A lista de workspaces do Log Analytics associados ao cluster.

Nome	Tipo	Description
associateDate	string	A hora da associação do workspace.
resourceId	string	ID de recurso do braço do workspace associado, na forma de: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string	ID imutável do workspace associado.
workspaceName	string	Nome do recurso do workspace associado.

BillingType

O tipo de cobrança do cluster.

Nome	Tipo	Description
Cluster	string
Workspaces	string

Capacity

O nível de reserva de capacidade em Gigabytes para esse cluster.

Nome	Tipo	Description
100	Integer
1000	Integer
10000	Integer
200	Integer
2000	Integer
25000	Integer
300	Integer
400	Integer
500	Integer
5000	Integer
50000	Integer

CapacityReservationProperties

As propriedades de Reserva de Capacidade.

Nome	Tipo	Description
lastSkuUpdate	string	A última vez que o Sku foi atualizado.
minCapacity	integer	Valor mínimo de CapacityReservation em Gigabytes.

Cluster

O contêiner de recursos de cluster do Log Analytics de nível superior.

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Identidade do recurso.
location	string	A localização geográfica em que o recurso reside
name	string	O nome do recurso
properties.associatedWorkspaces	AssociatedWorkspace[]	A lista de workspaces do Log Analytics associados ao cluster
properties.billingType	BillingType	O tipo de cobrança do cluster.
properties.capacityReservationProperties	CapacityReservationProperties	Propriedades adicionais para reserva de capacidade
properties.clusterId	string	A ID associada ao cluster.
properties.createdDate	string	O tempo de criação do cluster
properties.isAvailabilityZonesEnabled	boolean	Define se o cluster dará suporte a zonas de disponibilidade. Isso só pode ser definido como true em regiões em que o Azure Data Explorer suporte Zonas de Disponibilidade. Esta propriedade não pode ser modificada após a criação do cluster. O valor padrão será 'true' se a região der suporte a Zonas de Disponibilidade.
properties.isDoubleEncryptionEnabled	boolean	Configura se o cluster usará criptografia dupla. Esta propriedade não pode ser modificada após a criação do cluster. O valor padrão é 'true'
properties.keyVaultProperties	keyVaultProperties	As propriedades de chave associadas.
properties.lastModifiedDate	string	A última vez que o cluster foi atualizado.
properties.provisioningState	ClusterEntityStatus	O estado de provisionamento do cluster.
sku	ClusterSku	As propriedades de sku.
tags	object	Marcas de recurso.
type	string	Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

O estado de provisionamento do cluster.

Nome	Tipo	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
ProvisioningAccount	string
Succeeded	string
Updating	string

ClusterPatch

O contêiner de recursos de cluster do Log Analytics de nível superior.

Nome	Tipo	Description
identity	ManagedServiceIdentity	Identidade do recurso.
properties.billingType	BillingType	O tipo de cobrança do cluster.
properties.keyVaultProperties	keyVaultProperties	As propriedades de chave associadas.
sku	ClusterSku	As propriedades de sku.
tags	object	Marcas de recurso.

ClusterSku

A definição de sku do cluster.

Nome	Tipo	Description
capacity	Capacity	O nível de reserva de capacidade em Gigabytes para esse cluster.
name	ClusterSkuNameEnum	A SKU (camada) de um cluster.

ClusterSkuNameEnum

A SKU (camada) de um cluster.

Nome	Tipo	Description
CapacityReservation	string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

keyVaultProperties

As propriedades do cofre de chaves.

Nome	Tipo	Description
keyName	string	O nome da chave associada ao cluster do Log Analytics.
keyRsaSize	integer	Tamanho mínimo necessário da chave selecionada.
keyVaultUri	string	O uri Key Vault que contém a chave associada ao cluster do Log Analytics.
keyVersion	string	A versão da chave associada ao cluster do Log Analytics.

ManagedServiceIdentity

Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou atribuídas pelo usuário)

Nome	Tipo	Description
principalId	string	A ID da entidade de serviço da identidade atribuída pelo sistema. Essa propriedade só será fornecida para uma identidade atribuída pelo sistema.
tenantId	string	A ID do locatário da identidade atribuída pelo sistema. Essa propriedade só será fornecida para uma identidade atribuída pelo sistema.
type	ManagedServiceIdentityType	Tipo de identidade de serviço gerenciada (em que os tipos SystemAssigned e UserAssigned são permitidos).
userAssignedIdentities	<string, UserAssignedIdentity>	identidades User-Assigned O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações.

ManagedServiceIdentityType

Tipo de identidade de serviço gerenciada (em que os tipos SystemAssigned e UserAssigned são permitidos).

Nome	Tipo	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

Nome	Tipo	Description
clientId	string	A ID do cliente da identidade atribuída.
principalId	string	A ID da entidade de segurança da identidade atribuída.

Compartilhar via