Clusters - Create Or Update

Referencia

Servicio:: Log Analytics

Versión de la API:: 2023-09-01

Cree o actualice un clúster de Log Analytics.

PUT 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. Patrón de Regex: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
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	Requerido	Tipo	Description
location	True	string	Ubicación geográfica donde reside el recurso
identity		ManagedServiceIdentity	Identidad 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.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.
sku		ClusterSku	Propiedades de SKU.
tags		object	Etiquetas del recurso.

Respuestas

Nombre	Tipo	Description
200 OK	Cluster	Definición de respuesta correcta.
201 Created	Cluster	Definición de respuesta creada.
202 Accepted		Definición de respuesta aceptada.
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

ClustersCreate

Solicitud de ejemplo

HTTP

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

{
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Respuesta de muestra

status code:: 202

Location: https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685/operationresults/c0f02ffd-0d4e-491e-a10c-fb82a1543a77?api-version=2023-09-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/providers/Microsoft.OperationalInsights/locations/eastus/operationstatuses/c0f02ffd-0d4e-491e-a10c-fb82a1543a77?api-version=2023-09-01

status code:: 200

{
  "properties": {
    "keyVaultProperties": {
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyName": "aztest2170cert",
      "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
    },
    "provisioningState": "ProvisioningAccount",
    "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": [],
    "capacityReservationProperties": {
      "lastSkuUpdate": "Thu, 01 Jan 1970 00:00:00 GMT",
      "minCapacity": 100
    }
  },
  "id": "/subscriptions/594038b5-1093-476e-a366-482775671c11/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685",
  "identity": {
    "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "name": "oiautorest6685",
  "type": "Microsoft.OperationalInsights/clusters",
  "location": "australiasoutheast"
}

status code:: 201

{
  "properties": {
    "keyVaultProperties": {
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyName": "aztest2170cert",
      "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
    },
    "provisioningState": "ProvisioningAccount",
    "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": [],
    "capacityReservationProperties": {
      "lastSkuUpdate": "Thu, 01 Jan 1970 00:00:00 GMT",
      "minCapacity": 100
    }
  },
  "id": "/subscriptions/594038b5-1093-476e-a366-482775671c11/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685",
  "identity": {
    "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "name": "oiautorest6685",
  "type": "Microsoft.OperationalInsights/clusters",
  "location": "australiasoutheast"
}

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.
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

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.

Compartir a través de