Partilhar via


Operations Discovery - Get

GET https://management.azure.com/providers/Microsoft.Migrate/operations?api-version=2023-08-01

Parâmetros do URI

Name Em Necessário Tipo Description
api-version
query True

string

Versão da API do cliente.

Respostas

Name Tipo Description
200 OK

OperationsDiscoveryCollection

Sucesso

Other Status Codes

CloudError

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

OperationsDiscovery_Get

Pedido de amostra

GET https://management.azure.com/providers/Microsoft.Migrate/operations?api-version=2023-08-01

Resposta da amostra

{
  "value": [
    {
      "name": "Read",
      "display": {
        "provider": "Microsoft.Migrate",
        "resource": "Microsoft.Migrate/moveCollections",
        "operation": "Read",
        "description": "Reads the move collection."
      },
      "origin": "user"
    },
    {
      "name": "Write",
      "display": {
        "provider": "Microsoft.Migrate",
        "resource": "Microsoft.Migrate/moveCollections",
        "operation": "Write",
        "description": "Creates or updates a move collection."
      },
      "origin": "user"
    }
  ]
}

Definições

Name Description
CloudError

Uma resposta de erro do serviço.

CloudErrorBody

Uma resposta de erro do serviço.

Display

Contém as informações de exibição localizadas para esta operação / ação específica. Esses valores serão usados por vários clientes para (1) definições de função personalizadas para RBAC; (2) filtros de consulta complexos para o serviço de eventos; e (3) histórico/registos de auditoria das operações de gestão.

OperationsDiscovery

Classe de descoberta de operações.

OperationsDiscoveryCollection

Coleção de detalhes ClientDiscovery.

CloudError

Uma resposta de erro do serviço.

Name Tipo Description
error

CloudErrorBody

Corpo do erro na nuvem.

CloudErrorBody

Uma resposta de erro do serviço.

Name Tipo Description
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.

target

string

O alvo do erro específico. Por exemplo, o nome da propriedade em erro.

Display

Contém as informações de exibição localizadas para esta operação / ação específica. Esses valores serão usados por vários clientes para (1) definições de função personalizadas para RBAC; (2) filtros de consulta complexos para o serviço de eventos; e (3) histórico/registos de auditoria das operações de gestão.

Name Tipo Description
description

string

Obtém ou define a descrição. A descrição amigável localizada para a operação, como deve ser mostrado ao usuário. Deve ser minucioso, mas conciso – será usado em dicas de ferramentas e visualizações detalhadas. Orientação prescritiva para namespace: Leia qualquer recurso 'display.provider' Criar ou atualizar qualquer recurso 'display.provider' Excluir qualquer recurso 'display.provider' Executar qualquer outra ação em qualquer recurso 'display.provider' Orientação prescritiva para namespace: Leia qualquer 'display.resource' Criar ou atualizar qualquer 'display.resource' Excluir qualquer 'display.resource' 'ActionName' qualquer 'display.resources'.

operation

string

Obtém ou define a operação. O nome amigável localizado para a operação, como deve ser mostrado ao usuário. Deve ser conciso (para caber em dropdowns) mas claro (ou seja, auto-documentação). Deve usar Title Casing. Orientação prescritiva: Leia Criar ou Atualizar Excluir 'ActionName'.

provider

string

Obtém ou define o provedor. A forma amigável localizada do nome do provedor de recursos – espera-se que também inclua o editor/empresa responsável. Ele deve usar Title Casing e começar com "Microsoft" para serviços de terceiros 1st. por exemplo, "Microsoft Monitoring Insights" ou "Microsoft Compute.".

resource

string

Obtém ou define o recurso. A forma amigável localizada do recurso relacionado a esta ação/operação – deve corresponder à documentação pública do provedor de recursos. Deve usar Title Casing. Esse valor deve ser exclusivo para um tipo de URL específico (por exemplo, os tipos aninhados não devem reutilizar o campo display.resource do pai), por exemplo, "Máquinas Virtuais" ou "Coleções de Trabalhos do Agendador", ou "Tamanhos de VM de Máquina Virtual" ou "Trabalhos do Agendador".

OperationsDiscovery

Classe de descoberta de operações.

Name Tipo Description
display

Display

Contém as informações de exibição localizadas para esta operação / ação específica. Esses valores serão usados por vários clientes para (1) definições de função personalizadas para RBAC; (2) filtros de consulta complexos para o serviço de eventos; e (3) histórico/registos de auditoria das operações de gestão.

isDataAction

boolean

Indica se a operação é uma ação de dados

name

string

Obtém ou define Nome da API. O nome da operação que está sendo executada nesse objeto específico. Ele deve corresponder ao nome da ação que aparece no RBAC / o serviço de eventos. Exemplos de operações incluem:

  • Microsoft.Compute/virtualMachine/capture/action
  • Microsoft.Compute/virtualMachine/restart/action
  • Microsoft.Compute/virtualMachine/gravação
  • Microsoft.Compute/virtualMachine/read
  • Microsoft.Compute/virtualMachine/delete Cada ação deve incluir, na ordem: (1) Namespace do provedor de recursos (2) Hierarquia de tipo à qual a ação se aplica (por exemplo, servidor/bancos de dados para um banco de dados do SQL Azure) (3) Leitura, gravação, ação ou exclusão, indicando qual tipo se aplica. Se for um PUT/PATCH em uma coleção ou valor nomeado, Write deve ser usado. Se for um GET, Read deve ser usado. Se for um DELETE, Delete deve ser usado. Se for um POST, a ação deve ser usada. Como observação: todos os provedores de recursos precisariam incluir a operação "{Resource Provider Namespace}/register/action" em sua resposta. Essa API é usada para registrar seu serviço e deve incluir detalhes sobre a operação (por exemplo, um nome localizado para o provedor de recursos + quaisquer considerações especiais, como liberação de PII).
origin

string

Obtém ou define o Origin. O executor pretendido da operação; rege a exibição da operação no RBAC UX e na UX dos logs de auditoria. O valor padrão é "user,system".

properties

object

Propriedades ClientDiscovery.

OperationsDiscoveryCollection

Coleção de detalhes ClientDiscovery.

Name Tipo Description
nextLink

string

Obtém ou define o valor do próximo link.

value

OperationsDiscovery[]

Obtém ou define os detalhes do ClientDiscovery.