Recupera informações sobre um conjunto de disponibilidade.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}?api-version=2024-03-01
Parâmetros de URI
Nome |
Em |
Obrigatório |
Tipo |
Description |
availabilitySetName
|
path |
True
|
string
|
O nome do conjunto de disponibilidade.
|
resourceGroupName
|
path |
True
|
string
|
O nome do grupo de recursos.
|
subscriptionId
|
path |
True
|
string
|
Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
|
api-version
|
query |
True
|
string
|
Versão da API do cliente.
|
Respostas
Nome |
Tipo |
Description |
200 OK
|
AvailabilitySet
|
OK
|
Other Status Codes
|
CloudError
|
Resposta de erro que descreve por que a operação falhou.
|
Segurança
azure_auth
Fluxo do OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome |
Description |
user_impersonation
|
representar sua conta de usuário
|
Exemplos
AvailabilitySet_Get_MaximumSet_Gen
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/aaaaaaaaaaaa?api-version=2024-03-01
/**
* Samples for AvailabilitySets GetByResourceGroup.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
* availabilitySetExamples/AvailabilitySet_Get_MaximumSet_Gen.json
*/
/**
* Sample code: AvailabilitySet_Get_MaximumSet_Gen.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void availabilitySetGetMaximumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
azure.virtualMachines().manager().serviceClient().getAvailabilitySets()
.getByResourceGroupWithResponse("rgcompute", "aaaaaaaaaaaa", com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.compute import ComputeManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-compute
# USAGE
python availability_set_get_maximum_set_gen.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = ComputeManagementClient(
credential=DefaultAzureCredential(),
subscription_id="{subscription-id}",
)
response = client.availability_sets.get(
resource_group_name="rgcompute",
availability_set_name="aaaaaaaaaaaa",
)
print(response)
# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/availabilitySetExamples/AvailabilitySet_Get_MaximumSet_Gen.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armcompute_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/availabilitySetExamples/AvailabilitySet_Get_MaximumSet_Gen.json
func ExampleAvailabilitySetsClient_Get_availabilitySetGetMaximumSetGen() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewAvailabilitySetsClient().Get(ctx, "rgcompute", "aaaaaaaaaaaa", nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res.AvailabilitySet = armcompute.AvailabilitySet{
// Name: to.Ptr("myAvailabilitySet"),
// Type: to.Ptr("Microsoft.Compute/availabilitySets"),
// ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet"),
// Location: to.Ptr("westus"),
// Tags: map[string]*string{
// "key2505": to.Ptr("aa"),
// "key9626": to.Ptr("aaaaaaaaaaaaaaaaaaaa"),
// },
// Properties: &armcompute.AvailabilitySetProperties{
// PlatformFaultDomainCount: to.Ptr[int32](2),
// PlatformUpdateDomainCount: to.Ptr[int32](20),
// ProximityPlacementGroup: &armcompute.SubResource{
// ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"),
// },
// Statuses: []*armcompute.InstanceViewStatus{
// {
// Code: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaa"),
// DisplayStatus: to.Ptr("aaaaaa"),
// Level: to.Ptr(armcompute.StatusLevelTypesInfo),
// Message: to.Ptr("a"),
// Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-11-30T12:58:26.522Z"); return t}()),
// }},
// VirtualMachines: []*armcompute.SubResource{
// {
// ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"),
// }},
// },
// SKU: &armcompute.SKU{
// Name: to.Ptr("Classic"),
// Capacity: to.Ptr[int64](29),
// Tier: to.Ptr("aaaaaaaaaaaaaa"),
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Retrieves information about an availability set.
*
* @summary Retrieves information about an availability set.
* x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/availabilitySetExamples/AvailabilitySet_Get_MaximumSet_Gen.json
*/
async function availabilitySetGetMaximumSetGen() {
const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
const availabilitySetName = "aaaaaaaaaaaa";
const credential = new DefaultAzureCredential();
const client = new ComputeManagementClient(credential, subscriptionId);
const result = await client.availabilitySets.get(resourceGroupName, availabilitySetName);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
{
"location": "westus",
"properties": {
"platformFaultDomainCount": 2,
"platformUpdateDomainCount": 20,
"virtualMachines": [
{
"id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
}
],
"proximityPlacementGroup": {
"id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
},
"statuses": [
{
"code": "aaaaaaaaaaaaaaaaaaaaaaa",
"level": "Info",
"displayStatus": "aaaaaa",
"message": "a",
"time": "2021-11-30T12:58:26.522Z"
}
]
},
"sku": {
"name": "Classic",
"tier": "aaaaaaaaaaaaaa",
"capacity": 29
},
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet",
"name": "myAvailabilitySet",
"type": "Microsoft.Compute/availabilitySets",
"tags": {
"key9626": "aaaaaaaaaaaaaaaaaaaa",
"key2505": "aa"
}
}
AvailabilitySet_Get_MinimumSet_Gen
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/aaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
/**
* Samples for AvailabilitySets GetByResourceGroup.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
* availabilitySetExamples/AvailabilitySet_Get_MinimumSet_Gen.json
*/
/**
* Sample code: AvailabilitySet_Get_MinimumSet_Gen.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void availabilitySetGetMinimumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
azure.virtualMachines().manager().serviceClient().getAvailabilitySets()
.getByResourceGroupWithResponse("rgcompute", "aaaaaaaaaaaaaaaaaaaa", com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.compute import ComputeManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-compute
# USAGE
python availability_set_get_minimum_set_gen.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = ComputeManagementClient(
credential=DefaultAzureCredential(),
subscription_id="{subscription-id}",
)
response = client.availability_sets.get(
resource_group_name="rgcompute",
availability_set_name="aaaaaaaaaaaaaaaaaaaa",
)
print(response)
# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/availabilitySetExamples/AvailabilitySet_Get_MinimumSet_Gen.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armcompute_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/availabilitySetExamples/AvailabilitySet_Get_MinimumSet_Gen.json
func ExampleAvailabilitySetsClient_Get_availabilitySetGetMinimumSetGen() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewAvailabilitySetsClient().Get(ctx, "rgcompute", "aaaaaaaaaaaaaaaaaaaa", nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res.AvailabilitySet = armcompute.AvailabilitySet{
// ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet"),
// Location: to.Ptr("westus"),
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Retrieves information about an availability set.
*
* @summary Retrieves information about an availability set.
* x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/availabilitySetExamples/AvailabilitySet_Get_MinimumSet_Gen.json
*/
async function availabilitySetGetMinimumSetGen() {
const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
const availabilitySetName = "aaaaaaaaaaaaaaaaaaaa";
const credential = new DefaultAzureCredential();
const client = new ComputeManagementClient(credential, subscriptionId);
const result = await client.availabilitySets.get(resourceGroupName, availabilitySetName);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
{
"location": "westus",
"id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/availabilitySets/myAvailabilitySet"
}
Definições
Nome |
Description |
ApiError
|
Erro de API.
|
ApiErrorBase
|
Base de erros de API.
|
AvailabilitySet
|
Especifica informações sobre o conjunto de disponibilidade ao qual a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de disponibilidade são alocadas a nós diferentes para maximizar a disponibilidade. Para obter mais informações sobre conjuntos de disponibilidade, consulte Visão geral dos conjuntos de disponibilidade. Para obter mais informações sobre a manutenção planejada do Azure, consulte Manutenção e atualizações para Máquinas Virtuais no Azure. Atualmente, uma VM só pode ser adicionada a um conjunto de disponibilidade no momento da criação. Uma VM existente não pode ser adicionada a um conjunto de disponibilidade.
|
CloudError
|
Uma resposta de erro do serviço de computação.
|
InnerError
|
Detalhes do erro interno.
|
InstanceViewStatus
|
Exibição de instância status.
|
Sku
|
Descreve um sku de conjunto de dimensionamento de máquinas virtuais. OBSERVAÇÃO: se o novo SKU de VM não tiver suporte no hardware em que o conjunto de dimensionamento está atualmente, você precisará desalocar as VMs no conjunto de dimensionamento antes de modificar o nome da SKU.
|
StatusLevelTypes
|
O código de nível.
|
SubResource
|
|
ApiError
Erro de API.
Nome |
Tipo |
Description |
code
|
string
|
O código de erro.
|
details
|
ApiErrorBase[]
|
Os detalhes do erro da API
|
innererror
|
InnerError
|
O erro interno da API
|
message
|
string
|
A mensagem de erro.
|
target
|
string
|
O destino do erro específico.
|
ApiErrorBase
Base de erros de API.
Nome |
Tipo |
Description |
code
|
string
|
O código de erro.
|
message
|
string
|
A mensagem de erro.
|
target
|
string
|
O destino do erro específico.
|
AvailabilitySet
Especifica informações sobre o conjunto de disponibilidade ao qual a máquina virtual deve ser atribuída. As máquinas virtuais especificadas no mesmo conjunto de disponibilidade são alocadas a nós diferentes para maximizar a disponibilidade. Para obter mais informações sobre conjuntos de disponibilidade, consulte Visão geral dos conjuntos de disponibilidade. Para obter mais informações sobre a manutenção planejada do Azure, consulte Manutenção e atualizações para Máquinas Virtuais no Azure. Atualmente, uma VM só pode ser adicionada a um conjunto de disponibilidade no momento da criação. Uma VM existente não pode ser adicionada a um conjunto de disponibilidade.
Nome |
Tipo |
Description |
id
|
string
|
ID do recurso
|
location
|
string
|
Localização do recurso
|
name
|
string
|
Nome do recurso
|
properties.platformFaultDomainCount
|
integer
|
Contagem de domínios de falha.
|
properties.platformUpdateDomainCount
|
integer
|
Atualizar contagem de domínios.
|
properties.proximityPlacementGroup
|
SubResource
|
Especifica informações sobre o grupo de posicionamento por proximidade ao qual o conjunto de disponibilidade deve ser atribuído. Versão mínima da api: 2018-04-01.
|
properties.statuses
|
InstanceViewStatus[]
|
O recurso status informações.
|
properties.virtualMachines
|
SubResource[]
|
Uma lista de referências a todas as máquinas virtuais no conjunto de disponibilidade.
|
sku
|
Sku
|
Sku do conjunto de disponibilidade, somente o nome é necessário para ser definido. Consulte AvailabilitySetSkuTypes para obter um possível conjunto de valores. Use 'Aligned' para máquinas virtuais com discos gerenciados e 'Clássico' para máquinas virtuais com discos não gerenciados. O valor padrão é 'Clássico'.
|
tags
|
object
|
Marcações de recursos
|
type
|
string
|
Tipo de recurso
|
CloudError
Uma resposta de erro do serviço de computação.
Nome |
Tipo |
Description |
error
|
ApiError
|
Erro de API.
|
InnerError
Detalhes do erro interno.
Nome |
Tipo |
Description |
errordetail
|
string
|
A mensagem de erro interna ou despejo de exceção.
|
exceptiontype
|
string
|
O tipo de exceção.
|
InstanceViewStatus
Exibição de instância status.
Nome |
Tipo |
Description |
code
|
string
|
O código do status.
|
displayStatus
|
string
|
O rótulo localizável curto para o status.
|
level
|
StatusLevelTypes
|
O código de nível.
|
message
|
string
|
A mensagem de status detalhada, inclusive para alertas e mensagens de erro.
|
time
|
string
|
A hora do status.
|
Sku
Descreve um sku de conjunto de dimensionamento de máquinas virtuais. OBSERVAÇÃO: se o novo SKU de VM não tiver suporte no hardware em que o conjunto de dimensionamento está atualmente, você precisará desalocar as VMs no conjunto de dimensionamento antes de modificar o nome da SKU.
Nome |
Tipo |
Description |
capacity
|
integer
|
Especifica o número de máquinas virtuais no conjunto de dimensionamento.
|
name
|
string
|
O nome do sku.
|
tier
|
string
|
Especifica a camada de máquinas virtuais em um conjunto de dimensionamento.
Valores possíveis:
Standard
Basic
|
StatusLevelTypes
O código de nível.
Nome |
Tipo |
Description |
Error
|
string
|
|
Info
|
string
|
|
Warning
|
string
|
|
SubResource
Nome |
Tipo |
Description |
id
|
string
|
ID do recurso
|