Clusters - Update

Referência

Serviço:: Log Analytics

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

Atualiza 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 minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	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 o status detalhado.
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo 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 pelo usuário)
ManagedServiceIdentityType	Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).
UserAssignedIdentity	Propriedades de identidade atribuídas pelo usuário

AssociatedWorkspace

Objeto

A lista de workspaces do Log Analytics associados ao cluster.

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

BillingType

Enumeração

O tipo de cobrança do cluster.

Valor	Description
Cluster
Workspaces

Capacity

Enumeração

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

Valor	Description
100
1000
10000
200
2000
25000
300
400
500
5000
50000

CapacityReservationProperties

Objeto

As propriedades de Reserva de Capacidade.

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

Cluster

Objeto

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 onde 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	A hora de criação do cluster
properties.isAvailabilityZonesEnabled	boolean	Define se o cluster dará suporte a zonas de disponibilidade. Isso pode ser definido como true somente em regiões em que o Azure Data Explorer dá suporte a Zonas de Disponibilidade. Essa 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. Essa 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	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Enumeração

O estado de provisionamento do cluster.

Valor	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

ClusterPatch

Objeto

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

Objeto

A definição de sku do cluster.

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

ClusterSkuNameEnum

Enumeração

A SKU (camada) de um cluster.

Valor	Description
CapacityReservation

ErrorAdditionalInfo

Objeto

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

Objeto

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

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

keyVaultProperties

Objeto

As propriedades do cofre de chaves.

Nome	Tipo	Description
keyName	string	O nome da chave associada ao cluster do Log Analytics.
keyRsaSize	integer (int32)	Tamanho mínimo necessário da chave selecionada.
keyVaultUri	string	O uri do 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

Objeto

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

Nome	Tipo	Description
principalId	string (uuid)	A ID da entidade de serviço da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema.
tenantId	string (uuid)	A ID do locatário da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema.
type	ManagedServiceIdentityType	Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).
userAssignedIdentities	<string, UserAssignedIdentity>	Identidades de 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 do dicionário podem ser objetos vazios ({}) em solicitações.

ManagedServiceIdentityType

Enumeração

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

Valor	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

UserAssignedIdentity

Objeto

Propriedades de identidade atribuídas pelo usuário

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

Compartilhar via

Clusters - Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

ClustersPatch

Solicitação de exemplo

Resposta de exemplo

Definições

AssociatedWorkspace

BillingType

Capacity

CapacityReservationProperties

Cluster

ClusterEntityStatus

ClusterPatch

ClusterSku

ClusterSkuNameEnum

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

keyVaultProperties

ManagedServiceIdentity

ManagedServiceIdentityType

UserAssignedIdentity

Recursos adicionais