Partager via


Operations Discovery - Get

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

Paramètres URI

Nom Dans Obligatoire Type Description
api-version
query True

string

Version de l’API cliente.

Réponses

Nom Type Description
200 OK

OperationsDiscoveryCollection

Succès

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

OperationsDiscovery_Get

Exemple de requête

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

Exemple de réponse

{
  "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"
    }
  ]
}

Définitions

Nom Description
CloudError

Réponse d’erreur du service.

CloudErrorBody

Réponse d’erreur du service.

Display

Contient les informations d’affichage localisées pour cette opération/action particulière. Ces valeurs seront utilisées par plusieurs clients pour (1) les définitions de rôle personnalisées pour RBAC ; (2) filtres de requête complexes pour le service d’événements ; et (3) l’historique des audits/enregistrements pour les opérations de gestion.

OperationsDiscovery

Classe de découverte des opérations.

OperationsDiscoveryCollection

Collection de détails ClientDiscovery.

CloudError

Réponse d’erreur du service.

Nom Type Description
error

CloudErrorBody

Corps d’erreur cloud.

CloudErrorBody

Réponse d’erreur du service.

Nom Type Description
code

string

Identificateur de l'erreur. Les codes sont invariants et sont destinés à être consommés par programmation.

details

CloudErrorBody[]

Liste de détails supplémentaires sur l’erreur.

message

string

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.

target

string

Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

Display

Contient les informations d’affichage localisées pour cette opération/action particulière. Ces valeurs seront utilisées par plusieurs clients pour (1) les définitions de rôle personnalisées pour RBAC ; (2) filtres de requête complexes pour le service d’événements ; et (3) l’historique des audits/enregistrements pour les opérations de gestion.

Nom Type Description
description

string

Obtient ou définit la description. Description conviviale localisée pour l’opération, telle qu’elle doit s’afficher à l’utilisateur. Il doit être complet, mais concis : il sera utilisé dans des info-bulles et des vues détaillées. Conseils prescriptifs pour l’espace de noms : Lisez toute ressource « display.provider » Créer ou mettre à jour une ressource « display.provider » Supprimer toute ressource « display.provider » Effectuer toute autre action sur toute ressource « display.provider » Conseils prescriptifs pour l’espace de noms : Lisez toute ressource « display.resource » Créer ou mettre à jour une ressource « display.resource » Supprimer toute ressource « display.resource » « ActionName » tout « display.resources ».

operation

string

Obtient ou définit l’opération. Nom convivial localisé de l’opération, tel qu’il doit être affiché à l’utilisateur. Il doit être concis (pour tenir dans les listes déroulantes) mais clair (c’est-à-dire, auto-documentation). Il doit utiliser la casse de titre. Conseils prescriptifs : Lisez Créer ou mettre à jour supprimer « ActionName ».

provider

string

Obtient ou définit le fournisseur. Forme conviviale localisée du nom du fournisseur de ressources : elle doit également inclure le responsable de l’éditeur/de l’entreprise. Il doit utiliser la casse de titre et commencer par « Microsoft » pour les services tiers. par exemple, « Microsoft Monitoring Insights » ou « Microsoft Compute ».

resource

string

Obtient ou définit la ressource. Forme conviviale localisée de la ressource liée à cette action/opération : elle doit correspondre à la documentation publique du fournisseur de ressources. Il doit utiliser la casse de titre. Cette valeur doit être unique pour un type d’URL particulier (par exemple, les types imbriqués ne doivent pas réutiliser le champ display.resource de leur parent), par exemple « Machines Virtuelles » ou « Regroupements de travaux du planificateur », ou « Tailles de machine virtuelle » ou « Travaux du planificateur ».

OperationsDiscovery

Classe de découverte des opérations.

Nom Type Description
display

Display

Contient les informations d’affichage localisées pour cette opération/action particulière. Ces valeurs seront utilisées par plusieurs clients pour (1) les définitions de rôle personnalisées pour RBAC ; (2) filtres de requête complexes pour le service d’événements ; et (3) l’historique des audits/enregistrements pour les opérations de gestion.

isDataAction

boolean

Indique si l’opération est une action de données

name

string

Obtient ou définit le nom de l’API. Nom de l’opération en cours d’exécution sur cet objet particulier. Il doit correspondre au nom de l’action qui apparaît dans RBAC / le service d’événements. Voici quelques exemples d’opérations :

  • Microsoft.Compute/virtualMachine/capture/action
  • Microsoft.Compute/virtualMachine/restart/action
  • Microsoft.Compute/virtualMachine/write
  • Microsoft.Compute/virtualMachine/read
  • Microsoft.Compute/virtualMachine/delete Chaque action doit inclure, dans l’ordre : (1) Espace de noms du fournisseur de ressources (2) Hiérarchie de types pour laquelle l’action s’applique (par exemple, serveur/bases de données pour une base de données SQL Azure) (3) Lecture, Écriture, Action ou Suppression indiquant le type qui s’applique. S’il s’agit d’un PUT/PATCH sur une collection ou une valeur nommée, write doit être utilisé. S’il s’agit d’un GET, read doit être utilisé. S’il s’agit d’une opération DELETE, la suppression doit être utilisée. S’il s’agit d’un POST, action doit être utilisée. Remarque : tous les fournisseurs de ressources doivent inclure l’opération « {Espace de noms du fournisseur de ressources}/register/action » dans leur réponse. Cette API est utilisée pour s’inscrire à leur service et doit inclure des détails sur l’opération (par exemple, un nom localisé pour le fournisseur de ressources + toutes les considérations spéciales telles que la publication des informations personnelles).
origin

string

Obtient ou définit l’origine. Exécuteur prévu de l’opération ; régit l’affichage de l’opération dans l’expérience utilisateur RBAC et l’expérience utilisateur des journaux d’audit. La valeur par défaut est « user,system ».

properties

object

Propriétés ClientDiscovery.

OperationsDiscoveryCollection

Collection de détails ClientDiscovery.

Nom Type Description
nextLink

string

Obtient ou définit la valeur du lien suivant.

value

OperationsDiscovery[]

Obtient ou définit les détails de ClientDiscovery.