Clusters - Create Or Update

Referência

Serviço:: AVS

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

Criar um cluster

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AVS/privateClouds/{privateCloudName}/clusters/{clusterName}?api-version=2024-09-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
clusterName	path	True	string pattern: ^[-\w\._]+$	Nome do cluster
privateCloudName	path	True	string pattern: ^[-\w\._]+$	Nome da nuvem privada
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 (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
sku	True	Sku	A SKU (Unidade de Manutenção de Estoque) atribuída a esse recurso.
properties.clusterSize		integer (int32)	O tamanho do cluster
properties.hosts		string[]	Os hosts
properties.vsanDatastoreName		string	Nome do armazenamento de dados vsan associado ao cluster

Respostas

Nome	Tipo	Description
200 OK	Cluster	Operação de atualização do recurso 'Cluster' bem-sucedida
201 Created	Cluster	Operação de criação de recurso 'Cluster' bem-sucedida Cabeçalhos Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Description

200 OK

Cluster

Operação de atualização do recurso 'Cluster' bem-sucedida

201 Created

Cluster

Operação de criação de recurso 'Cluster' bem-sucedida

Cabeçalhos

Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

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

Clusters_CreateOrUpdate

Solicitação de exemplo

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/clusters/cluster1?api-version=2024-09-01

{
  "sku": {
    "name": "AV20"
  },
  "properties": {
    "clusterSize": 3
  }
}

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/clusters/cluster1",
  "name": "cluster1",
  "sku": {
    "name": "AV20"
  },
  "properties": {
    "clusterSize": 3,
    "hosts": [
      "fakehost22.nyc1.kubernetes.center",
      "fakehost23.nyc1.kubernetes.center",
      "fakehost24.nyc1.kubernetes.center"
    ],
    "provisioningState": "Succeeded"
  },
  "type": "Microsoft.AVS/privateClouds/clusters"
}

Código de status:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AVS/privateClouds/cloud1/clusters/cluster1",
  "name": "cluster1",
  "sku": {
    "name": "AV20"
  },
  "properties": {
    "clusterSize": 3,
    "provisioningState": "Updating"
  },
  "type": "Microsoft.AVS/privateClouds/clusters"
}

Definições

Nome	Description
Cluster	Um recurso de cluster
ClusterProvisioningState	Estado de provisionamento de cluster
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
Sku	A definição do modelo de recurso que representa o SKU
SkuTier	Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT.
systemData	Metadados relativos à criação e última modificação do recurso.

Cluster

Objeto

Um recurso de cluster

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.clusterId	integer (int32)	A identidade
properties.clusterSize	integer (int32)	O tamanho do cluster
properties.hosts	string[]	Os hosts
properties.provisioningState	ClusterProvisioningState	O estado do provisionamento de cluster
properties.vsanDatastoreName	string	Nome do armazenamento de dados vsan associado ao cluster
sku	Sku	A SKU (Unidade de Manutenção de Estoque) atribuída a esse recurso.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ClusterProvisioningState

Enumeração

Estado de provisionamento de cluster

Valor	Description
Canceled	A criação de recursos foi cancelada.
Cancelled	é cancelado
Deleting	está excluindo
Failed	Falha na criação de recursos.
Succeeded	O recurso foi criado.
Updating	está atualizando

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

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.

Sku

Objeto

A definição do modelo de recurso que representa o SKU

Nome	Tipo	Description
capacity	integer (int32)	Se o SKU der suporte a expansão/entrada, o inteiro de capacidade deverá ser incluído. Se a escala horizontal/in não for possível para o recurso, isso poderá ser omitido.
family	string	Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui.
name	string	O nome da SKU. Por exemplo, P3. Normalmente, é um código letter+number
size	string	O tamanho da SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo.
tier	SkuTier	Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT.

SkuTier

Enumeração

Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT.

Valor	Description
Basic
Free
Premium
Standard

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Compartilhar via

Clusters - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Clusters_CreateOrUpdate

Solicitação de exemplo

Resposta de exemplo

Definições

Cluster

ClusterProvisioningState

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Sku

SkuTier

systemData