Partilhar via


Offers - List

Obtenha a lista de ofertas em um grupo de recursos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Subscriptions.Admin/offers?api-version=2015-11-01

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O grupo de recursos no qual o recurso está localizado.

subscriptionId
path True

string

Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.

api-version
query True

string

Versão da API do cliente.

Respostas

Name Tipo Description
200 OK

OfferList

OK

Other Status Codes

Error

Erro inesperado

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Get the list of offers under a resource group.

Pedido de amostra

GET https://management.azure.com/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/RG1/providers/Microsoft.Subscriptions.Admin/offers?api-version=2015-11-01

Resposta da amostra

{
  "value": [
    {
      "id": "/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/RG1/providers/Microsoft.Subscriptions.Admin/offers/sampleoffer1",
      "name": "sampleoffer1",
      "type": "Microsoft.Subscriptions.Admin/offers",
      "location": "local",
      "properties": {
        "name": "sampleoffer1",
        "displayName": "SampleOffer1",
        "description": "",
        "externalReferenceId": "",
        "state": "Public",
        "subscriptionCount": 1,
        "maxSubscriptionsPerAccount": 0,
        "basePlanIds": [
          "/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/RG1/providers/Microsoft.Subscriptions.Admin/plans/sampleplan1"
        ]
      }
    },
    {
      "id": "/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/ascansubscrrg479/providers/Microsoft.Subscriptions.Admin/offers/sampleoffer2",
      "name": "sampleoffer2",
      "type": "Microsoft.Subscriptions.Admin/offers",
      "location": "local",
      "tags": {},
      "properties": {
        "name": "sampleoffer2",
        "displayName": "sampleoffer2",
        "state": "Public",
        "subscriptionCount": 0,
        "maxSubscriptionsPerAccount": 0,
        "basePlanIds": [
          "/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/ascansubscrrg479/providers/Microsoft.Subscriptions.Admin/plans/sampleoffer2"
        ]
      }
    }
  ]
}

Definições

Name Description
AccessibilityState

Representa o estado da oferta

AddonPlanDefinition

Contém o nome do plano desejado a ser vinculado ou desvinculado de uma oferta.

Error

Resposta de erro.

ErrorDefinition

Definição de erro.

Offer

Representa uma oferta de serviços em relação à qual uma assinatura pode ser criada.

OfferList

Lista de ofertas.

AccessibilityState

Representa o estado da oferta

Valor Description
Private

A oferta ou plano é privado. Somente um administrador pode vê-lo e gerenciá-lo.

Public

A oferta ou plano é público. Os usuários podem vê-lo e se auto-inscrever nele.

Decommissioned

A oferta ou plano é desativado. As subscrições atuais ainda podem consumi-lo, mas as novas subscrições não.

AddonPlanDefinition

Contém o nome do plano desejado a ser vinculado ou desvinculado de uma oferta.

Name Tipo Description
maxAcquisitionCount

integer (int32)

Número máximo de instâncias que podem ser adquiridas por uma única assinatura. Se não for especificado, o valor assumido é 1.

planId

string

Identificador do plano.

Error

Resposta de erro.

Name Tipo Description
error

ErrorDefinition

Os detalhes do erro.

ErrorDefinition

Definição de erro.

Name Tipo Description
code

string

Código de erro específico do serviço que serve como substatus para o código de erro HTTP.

details

ErrorDefinition[]

Detalhes do erro interno.

message

string

Descrição do erro.

Offer

Representa uma oferta de serviços em relação à qual uma assinatura pode ser criada.

Name Tipo Description
id

string

URI do recurso.

location

string

Localização do recurso

name

string

Nome do recurso.

properties.addonPlans

AddonPlanDefinition[]

Referências a planos complementares que um inquilino pode opcionalmente adquirir como parte da oferta.

properties.basePlanIds

string[]

Identificadores dos planos base que ficam disponíveis para o locatário imediatamente quando um locatário assina a oferta.

properties.description

string

Descrição da oferta.

properties.displayName

string

Nome de exibição da oferta.

properties.externalReferenceId

string

Identificador de referência externo.

properties.maxSubscriptionsPerAccount

integer (int32)

Máximo de subscrições por conta.

properties.name

string

Nome da Oferta.

properties.state

AccessibilityState

Oferecer estado de acessibilidade.

properties.subscriptionCount

integer (int32)

Contagem de assinaturas atuais.

tags

object

Lista de pares chave-valor.

type

string

Tipo de recurso.

OfferList

Lista de ofertas.

Name Tipo Description
nextLink

string

URI para a próxima página.

value

Offer[]

Lista de ofertas.