Partilhar via


User Subscription - List

Lista a coleção de subscrições do utilizador especificado.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/subscriptions?api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}/subscriptions?$filter={$filter}&$top={$top}&$skip={$skip}&api-version=2022-08-01

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.

serviceName
path True

string

O nome do serviço Gestão de API.

Padrão Regex: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

O ID da subscrição de destino.

userId
path True

string

Identificador de utilizador. Tem de ser exclusivo na instância de serviço de Gestão de API atual.

api-version
query True

string

A versão da API a utilizar para esta operação.

$filter
query

string

| Campo | Utilização | Operadores suportados | Funções suportadas |
|-------------|------------------------|-----------------------------------|
|nome | filtro | ge, le, eq, ne, gt, lt | subcadeia, contém, começa com, termina com |
|displayName | filtro | ge, le, eq, ne, gt, lt | subcadeia, contém, começa com, termina com |
|stateComment | filtro | ge, le, eq, ne, gt, lt | subcadeia, contém, começa com, termina com |
|ownerId | filtro | ge, le, eq, ne, gt, lt | subcadeia, contém, começa com, termina com |
|âmbito | filtro | ge, le, eq, ne, gt, lt | subcadeia, contém, começa com, termina com |
|userId | filtro | ge, le, eq, ne, gt, lt | subcadeia, contém, começa com, termina com |
|productId | filtro | ge, le, eq, ne, gt, lt | subcadeia, contém, começa com, termina com |

$skip
query

integer

int32

Número de registos a ignorar.

$top
query

integer

int32

Número de registos a devolver.

Respostas

Name Tipo Description
200 OK

SubscriptionCollection

Lista uma coleção de entidades de Subscrição.

Other Status Codes

ErrorResponse

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

ApiManagementListUserSubscriptions

Pedido de amostra

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf/subscriptions?api-version=2022-08-01

Resposta da amostra

{
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf/subscriptions/57681850a40f7eb6c49f6ae3",
      "type": "Microsoft.ApiManagement/service/users/subscriptions",
      "name": "57681850a40f7eb6c49f6ae3",
      "properties": {
        "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf",
        "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5768181ea40f7eb6c49f6ac7",
        "displayName": "57681850a40f7eb6c49f6ae5",
        "state": "active",
        "createdDate": "2016-06-20T16:22:39.547Z",
        "startDate": "2016-06-20T00:00:00Z"
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf/subscriptions/57681850a40f7eb6c49f6b2b",
      "type": "Microsoft.ApiManagement/service/users/subscriptions",
      "name": "57681850a40f7eb6c49f6b2b",
      "properties": {
        "ownerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/57681833a40f7eb6c49f6acf",
        "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5768181ea40f7eb6c49f6ac7",
        "displayName": "57681850a40f7eb6c49f6b2d",
        "state": "active",
        "createdDate": "2016-06-20T16:22:41.103Z",
        "startDate": "2016-06-20T00:00:00Z"
      }
    }
  ],
  "nextLink": ""
}

Definições

Name Description
ErrorFieldContract

Contrato de campo de erro.

ErrorResponse

Resposta a Erros.

SubscriptionCollection

Representação da lista de Subscrições Paginadas.

SubscriptionContract

Detalhes da subscrição.

SubscriptionState

Estado da subscrição. Os estados possíveis estão * ativos – a subscrição está ativa, * suspensa – a subscrição está bloqueada e o subscritor não pode chamar as APIs do produto, * submetidas – o pedido de subscrição foi feito pelo programador, mas ainda não foi aprovado ou rejeitado, * rejeitado – o pedido de subscrição foi negado por um administrador, * cancelado – a subscrição foi cancelada pelo programador ou administrador, * expirou – a subscrição atingiu a data de expiração e foi desativada.

ErrorFieldContract

Contrato de campo de erro.

Name Tipo Description
code

string

Código de erro ao nível da propriedade.

message

string

Representação legível por humanos do erro ao nível da propriedade.

target

string

Nome da propriedade.

ErrorResponse

Resposta a Erros.

Name Tipo Description
error.code

string

Código de erro definido pelo serviço. Este código serve como um sub-estado para o código de erro HTTP especificado na resposta.

error.details

ErrorFieldContract[]

A lista de campos inválidos enviados a pedido, em caso de erro de validação.

error.message

string

Representação legível por humanos do erro.

SubscriptionCollection

Representação da lista de Subscrições Paginadas.

Name Tipo Description
count

integer

Número total de contagem de registos em todas as páginas.

nextLink

string

Ligação da página seguinte, se existir.

value

SubscriptionContract[]

Valores de página.

SubscriptionContract

Detalhes da subscrição.

Name Tipo Description
id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties.allowTracing

boolean

Determina se o rastreio está ativado

properties.createdDate

string

Data de criação da subscrição. A data está em conformidade com o seguinte formato: yyyy-MM-ddTHH:mm:ssZ conforme especificado pela norma ISO 8601.

properties.displayName

string

O nome da subscrição ou nulo se a subscrição não tiver nome.

properties.endDate

string

Data em que a subscrição foi cancelada ou expirou. A definição destina-se apenas a fins de auditoria e a subscrição não é cancelada automaticamente. O ciclo de vida da subscrição pode ser gerido com a state propriedade . A data está em conformidade com o seguinte formato: yyyy-MM-ddTHH:mm:ssZ conforme especificado pela norma ISO 8601.

properties.expirationDate

string

Data de expiração da subscrição. A definição destina-se apenas a fins de auditoria e a subscrição não expira automaticamente. O ciclo de vida da subscrição pode ser gerido com a state propriedade . A data está em conformidade com o seguinte formato: yyyy-MM-ddTHH:mm:ssZ conforme especificado pela norma ISO 8601.

properties.notificationDate

string

Data de notificação de expiração da subscrição futura. A data está em conformidade com o seguinte formato: yyyy-MM-ddTHH:mm:ssZ conforme especificado pela norma ISO 8601.

properties.ownerId

string

O identificador de recurso do utilizador do proprietário da subscrição. O valor é um URL relativo válido no formato de /users/{userId} em que {userId} é um identificador de utilizador.

properties.primaryKey

string

Chave primária da subscrição. Esta propriedade não será preenchida em operações "GET"! Utilize o pedido POST "/listSecrets" para obter o valor.

properties.scope

string

Âmbito como /products/{productId} ou /apis ou /apis/{apiId}.

properties.secondaryKey

string

Chave secundária da subscrição. Esta propriedade não será preenchida em operações "GET"! Utilize o pedido POST "/listSecrets" para obter o valor.

properties.startDate

string

Data de ativação da subscrição. A definição destina-se apenas a fins de auditoria e a subscrição não é ativada automaticamente. O ciclo de vida da subscrição pode ser gerido com a state propriedade . A data está em conformidade com o seguinte formato: yyyy-MM-ddTHH:mm:ssZ conforme especificado pela norma ISO 8601.

properties.state

SubscriptionState

Estado da subscrição. Os estados possíveis estão * ativos – a subscrição está ativa, * suspensa – a subscrição está bloqueada e o subscritor não pode chamar as APIs do produto, * submetidas – o pedido de subscrição foi feito pelo programador, mas ainda não foi aprovado ou rejeitado, * rejeitado – o pedido de subscrição foi negado por um administrador, * cancelado – a subscrição foi cancelada pelo programador ou administrador, * expirou – a subscrição atingiu a data de expiração e foi desativada.

properties.stateComment

string

Comentário de subscrição opcional adicionado por um administrador quando o estado é alterado para "rejeitado".

type

string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SubscriptionState

Estado da subscrição. Os estados possíveis estão * ativos – a subscrição está ativa, * suspensa – a subscrição está bloqueada e o subscritor não pode chamar as APIs do produto, * submetidas – o pedido de subscrição foi feito pelo programador, mas ainda não foi aprovado ou rejeitado, * rejeitado – o pedido de subscrição foi negado por um administrador, * cancelado – a subscrição foi cancelada pelo programador ou administrador, * expirou – a subscrição atingiu a data de expiração e foi desativada.

Name Tipo Description
active

string

cancelled

string

expired

string

rejected

string

submitted

string

suspended

string