Compartir a través de

Clusters - Update

  • Referencia
Servicio:
Log Analytics
Versión de la API:
2023-09-01

Novedades un clúster de Log Analytics.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
clusterName
 path True

string

Nombre del clúster de Log Analytics.
resourceGroupName
 path True

string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId
 path True

string

Identificador de la suscripción de destino.
api-version
 query True

string

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre Tipo Description
identity

ManagedServiceIdentity

Identidad del recurso.
properties.billingType

BillingType

Tipo de facturación del clúster.
properties.keyVaultProperties

keyVaultProperties

Propiedades de clave asociadas.
sku

ClusterSku

Propiedades de SKU.
tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

Cluster

El clúster existente se actualizó correctamente. Compruebe provisioningStatus para ver el estado detallado.
Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

ClustersPatch

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:
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"
}

Definiciones

Nombre Description
AssociatedWorkspace

Lista de áreas de trabajo de Log Analytics asociadas al clúster.
BillingType

Tipo de facturación del clúster.
Capacity

Nivel de reserva de capacidad en Gigabytes para este clúster.
CapacityReservationProperties

Propiedades de reserva de capacidad.
Cluster

Contenedor de recursos de clúster de Log Analytics de nivel superior.
ClusterEntityStatus

Estado de aprovisionamiento del clúster.
ClusterPatch

Contenedor de recursos de clúster de Log Analytics de nivel superior.
ClusterSku

Definición de SKU del clúster.
ClusterSkuNameEnum

SKU (nivel) de un clúster.
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ErrorDetail

Detalle del error.
ErrorResponse

Respuesta de error
keyVaultProperties

Propiedades del almacén de claves.
ManagedServiceIdentity

Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)
ManagedServiceIdentityType

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
UserAssignedIdentity

Propiedades de identidad asignadas por el usuario

AssociatedWorkspace

Lista de áreas de trabajo de Log Analytics asociadas al clúster.

Nombre Tipo Description
associateDate

string

Hora de asociación del área de trabajo.
resourceId

string

Identificador de recurso del arm del área de trabajo asociado, en forma de: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId

string

Identificador inmutable del área de trabajo asociada.
workspaceName

string

Nombre del recurso del área de trabajo asociado.

BillingType

Tipo de facturación del clúster.

Nombre Tipo Description
Cluster

string

Workspaces

string

Capacity

Nivel de reserva de capacidad en Gigabytes para este clúster.

Nombre 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

Propiedades de reserva de capacidad.

Nombre Tipo Description
lastSkuUpdate

string

La última vez que se actualizó la SKU.
minCapacity

integer

Valor de CapacityReservation mínimo en Gigabytes.

Cluster

Contenedor de recursos de clúster de Log Analytics de nivel superior.

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity

ManagedServiceIdentity

Identidad del recurso.
location

string

Ubicación geográfica donde reside el recurso
name

string

Nombre del recurso.
properties.associatedWorkspaces

AssociatedWorkspace[]

Lista de áreas de trabajo de Log Analytics asociadas al clúster
properties.billingType

BillingType

Tipo de facturación del clúster.
properties.capacityReservationProperties

CapacityReservationProperties

Propiedades adicionales para la reserva de capacidad
properties.clusterId

string

Identificador asociado al clúster.
properties.createdDate

string

Hora de creación del clúster
properties.isAvailabilityZonesEnabled

boolean

Establece si el clúster admitirá zonas de disponibilidad. Esto se puede establecer como true solo en las regiones en las que Azure Data Explorer admiten Availability Zones. Esta propiedad no se puede modificar después de la creación del clúster. El valor predeterminado es "true" si la región admite Availability Zones.
properties.isDoubleEncryptionEnabled

boolean

Configura si el clúster usará el cifrado doble. Esta propiedad no se puede modificar después de la creación del clúster. El valor predeterminado es "true"
properties.keyVaultProperties

keyVaultProperties

Propiedades de clave asociadas.
properties.lastModifiedDate

string

La última vez que se actualizó el clúster.
properties.provisioningState

ClusterEntityStatus

Estado de aprovisionamiento del clúster.
sku

ClusterSku

Propiedades de SKU.
tags

object

Etiquetas del recurso.
type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Estado de aprovisionamiento del clúster.

Nombre Tipo Description
Canceled

string

Creating

string

Deleting

string

Failed

string

ProvisioningAccount

string

Succeeded

string

Updating

string

ClusterPatch

Contenedor de recursos de clúster de Log Analytics de nivel superior.

Nombre Tipo Description
identity

ManagedServiceIdentity

Identidad del recurso.
properties.billingType

BillingType

Tipo de facturación del clúster.
properties.keyVaultProperties

keyVaultProperties

Propiedades de clave asociadas.
sku

ClusterSku

Propiedades de SKU.
tags

object

Etiquetas del recurso.

ClusterSku

Definición de SKU del clúster.

Nombre Tipo Description
capacity

Capacity

Nivel de reserva de capacidad en Gigabytes para este clúster.
name

ClusterSkuNameEnum

SKU (nivel) de un clúster.

ClusterSkuNameEnum

SKU (nivel) de un clúster.

Nombre Tipo Description
CapacityReservation

string

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Código de error.
details

ErrorDetail[]

Los detalles del error.
message

string

El mensaje de error.
target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

keyVaultProperties

Propiedades del almacén de claves.

Nombre Tipo Description
keyName

string

Nombre de la clave asociada al clúster de Log Analytics.
keyRsaSize

integer

Tamaño mínimo necesario de clave seleccionado.
keyVaultUri

string

El URI de Key Vault que contiene la clave asociada al clúster de Log Analytics.
keyVersion

string

Versión de la clave asociada al clúster de Log Analytics.

ManagedServiceIdentity

Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)

Nombre Tipo Description
principalId

string

Identificador de la entidad de servicio de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
tenantId

string

Identificador de inquilino de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
type

ManagedServiceIdentityType

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
userAssignedIdentities

<string,  UserAssignedIdentity>

identidades de User-Assigned
Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves del diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.

ManagedServiceIdentityType

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

Nombre Tipo Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

UserAssignedIdentity

Propiedades de identidad asignadas por el usuario

Nombre Tipo Description
clientId

string

Identificador de cliente de la identidad asignada.
principalId

string

Identificador de entidad de seguridad de la identidad asignada.