Partager via


Role Eligibility Schedule Requests - Create

Crée une demande de planification d’éligibilité de rôle.

PUT https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleEligibilityScheduleRequests/{roleEligibilityScheduleRequestName}?api-version=2020-10-01

Paramètres URI

Nom Dans Obligatoire Type Description
roleEligibilityScheduleRequestName
path True

string

Nom de l’éligibilité au rôle à créer. Il peut s’agir de n’importe quel GUID valide.

scope
path True

string

Étendue de la demande de planification d’éligibilité de rôle à créer. L’étendue peut être n’importe quelle ressource REST instance. Par exemple, utilisez « /subscriptions/{subscription-id}/ » pour un abonnement, « /subscriptions/subscription-id}/resourceGroups/{resource-group-name} » pour un groupe de ressources et « /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/{resource-provider}/{resource-type}/{resource-name} » pour une ressource.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
properties.principalId True

string

ID principal.

properties.requestType True

RequestType

Type de la demande de planification d’attribution de rôle. Par exemple : SelfActivate, AdminAssign, etc.

properties.roleDefinitionId True

string

ID de définition de rôle.

properties.condition

string

Conditions sur l’attribution de rôle. Cela limite les ressources auxquelles il peut être affecté. par exemple : @Resource[Microsoft.Storage/storageAccounts/blobServices/containers :ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Version de la condition. La valeur actuellement acceptée est « 2.0 »

properties.justification

string

Justification de l’éligibilité au rôle

properties.scheduleInfo

ScheduleInfo

Informations de planification de la planification d’éligibilité des rôles

properties.targetRoleEligibilityScheduleId

string

ID de planification d’éligibilité du rôle résultant ou ID de planification d’éligibilité du rôle mis à jour

properties.targetRoleEligibilityScheduleInstanceId

string

La planification d’éligibilité des rôles instance ID en cours de mise à jour

properties.ticketInfo

TicketInfo

Informations de ticket sur l’éligibilité du rôle

Réponses

Nom Type Description
201 Created

RoleEligibilityScheduleRequest

Créé : retourne des informations sur la demande de planification d’éligibilité du rôle.

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

PutRoleEligibilityScheduleRequest

Exemple de requête

PUT https://management.azure.com/providers/Microsoft.Subscription/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleEligibilityScheduleRequests/64caffb6-55c0-4deb-a585-68e948ea1ad6?api-version=2020-10-01

{
  "properties": {
    "principalId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
    "roleDefinitionId": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/c8d4ff99-41c3-41a8-9f60-21dfdad59608",
    "requestType": "AdminAssign",
    "scheduleInfo": {
      "startDateTime": "2020-09-09T21:31:27.91Z",
      "expiration": {
        "type": "AfterDuration",
        "endDateTime": null,
        "duration": "P365D"
      }
    },
    "condition": "@Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'",
    "conditionVersion": "1.0"
  }
}

Exemple de réponse

{
  "properties": {
    "targetRoleEligibilityScheduleId": "b1477448-2cc6-4ceb-93b4-54a202a89413",
    "targetRoleEligibilityScheduleInstanceId": null,
    "scope": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f",
    "roleDefinitionId": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/c8d4ff99-41c3-41a8-9f60-21dfdad59608",
    "principalId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
    "principalType": "User",
    "requestType": "AdminAssign",
    "status": "Provisioned",
    "approvalId": null,
    "scheduleInfo": {
      "startDateTime": "2020-09-09T21:31:27.91Z",
      "expiration": {
        "type": "AfterDuration",
        "endDateTime": null,
        "duration": "P365D"
      }
    },
    "ticketInfo": {
      "ticketNumber": null,
      "ticketSystem": null
    },
    "justification": null,
    "requestorId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
    "createdOn": "2020-09-09T21:32:27.91Z",
    "condition": "@Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'",
    "conditionVersion": "1.0",
    "expandedProperties": {
      "scope": {
        "id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f",
        "displayName": "Pay-As-You-Go",
        "type": "subscription"
      },
      "roleDefinition": {
        "id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/c8d4ff99-41c3-41a8-9f60-21dfdad59608",
        "displayName": "Contributor",
        "type": "BuiltInRole"
      },
      "principal": {
        "id": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
        "displayName": "User Account",
        "email": "user@my-tenant.com",
        "type": "User"
      }
    }
  },
  "name": "64caffb6-55c0-4deb-a585-68e948ea1ad6",
  "id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/RoleEligibilityScheduleRequests/64caffb6-55c0-4deb-a585-68e948ea1ad6",
  "type": "Microsoft.Authorization/RoleEligibilityScheduleRequests"
}

Définitions

Nom Description
CloudError

Réponse d’erreur du service.

CloudErrorBody

Réponse d’erreur du service.

ExpandedProperties

Informations développées sur la ressource, le rôle et le principal

Expiration

Expiration de la planification d’éligibilité des rôles

Principal

Détails du principal

principalType

Type principal de l’ID principal attribué.

RequestType

Type de la demande de planification d’attribution de rôle. Par exemple : SelfActivate, AdminAssign, etc.

RoleDefinition

Détails de la définition de rôle

RoleEligibilityScheduleRequest

Demande de planification d’éligibilité des rôles

ScheduleInfo

Informations de planification de la planification d’éligibilité des rôles

Scope

Détails de l’étendue des ressources

Status

Status de la demande de planification d’éligibilité au rôle.

TicketInfo

Informations de ticket sur l’éligibilité du rôle

Type

Type d’expiration de la planification d’éligibilité des rôles

CloudError

Réponse d’erreur du service.

Nom Type Description
error

CloudErrorBody

Réponse d’erreur du service.

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.

message

string

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

ExpandedProperties

Informations développées sur la ressource, le rôle et le principal

Nom Type Description
principal

Principal

Détails du principal

roleDefinition

RoleDefinition

Détails de la définition de rôle

scope

Scope

Détails de l’étendue des ressources

Expiration

Expiration de la planification d’éligibilité des rôles

Nom Type Description
duration

string

Durée de la planification d’éligibilité des rôles dans TimeSpan.

endDateTime

string

DateTime de fin de la planification d’éligibilité du rôle.

type

Type

Type d’expiration de la planification d’éligibilité des rôles

Principal

Détails du principal

Nom Type Description
displayName

string

Nom d’affichage du principal

email

string

id Email du principal

id

string

ID du principal

type

string

Type du principal

principalType

Type principal de l’ID principal attribué.

Nom Type Description
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RequestType

Type de la demande de planification d’attribution de rôle. Par exemple : SelfActivate, AdminAssign, etc.

Nom Type Description
AdminAssign

string

AdminExtend

string

AdminRemove

string

AdminRenew

string

AdminUpdate

string

SelfActivate

string

SelfDeactivate

string

SelfExtend

string

SelfRenew

string

RoleDefinition

Détails de la définition de rôle

Nom Type Description
displayName

string

Nom d’affichage de la définition de rôle

id

string

ID de la définition de rôle

type

string

Type de la définition de rôle

RoleEligibilityScheduleRequest

Demande de planification d’éligibilité des rôles

Nom Type Description
id

string

ID de demande de planification d’éligibilité au rôle.

name

string

Nom de la demande de planification d’éligibilité au rôle.

properties.approvalId

string

ApprovalId de la demande de planification d’éligibilité du rôle.

properties.condition

string

Conditions sur l’attribution de rôle. Cela limite les ressources auxquelles il peut être affecté. par exemple : @Resource[Microsoft.Storage/storageAccounts/blobServices/containers :ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Version de la condition. La valeur actuellement acceptée est « 2.0 »

properties.createdOn

string

DateTime lors de la création d’une demande de planification d’éligibilité de rôle

properties.expandedProperties

ExpandedProperties

Propriétés supplémentaires du principal, de l’étendue et de la définition de rôle

properties.justification

string

Justification de l’éligibilité au rôle

properties.principalId

string

ID principal.

properties.principalType

principalType

Type principal de l’ID principal attribué.

properties.requestType

RequestType

Type de la demande de planification d’attribution de rôle. Par exemple : SelfActivate, AdminAssign, etc.

properties.requestorId

string

ID de l’utilisateur qui a créé cette demande

properties.roleDefinitionId

string

ID de définition de rôle.

properties.scheduleInfo

ScheduleInfo

Informations de planification de la planification d’éligibilité des rôles

properties.scope

string

Étendue de la demande de planification d’éligibilité du rôle.

properties.status

Status

Status de la demande de planification d’éligibilité au rôle.

properties.targetRoleEligibilityScheduleId

string

ID de planification d’éligibilité du rôle résultant ou ID de planification d’éligibilité du rôle mis à jour

properties.targetRoleEligibilityScheduleInstanceId

string

La planification d’éligibilité des rôles instance ID en cours de mise à jour

properties.ticketInfo

TicketInfo

Informations de ticket sur l’éligibilité du rôle

type

string

Type de demande de planification d’éligibilité de rôle.

ScheduleInfo

Informations de planification de la planification d’éligibilité des rôles

Nom Type Description
expiration

Expiration

Expiration de la planification d’éligibilité des rôles

startDateTime

string

DateHeure de début de la planification d’éligibilité du rôle.

Scope

Détails de l’étendue des ressources

Nom Type Description
displayName

string

Nom d’affichage de la ressource

id

string

ID d’étendue de la ressource

type

string

Type de la ressource

Status

Status de la demande de planification d’éligibilité au rôle.

Nom Type Description
Accepted

string

AdminApproved

string

AdminDenied

string

Canceled

string

Denied

string

Failed

string

FailedAsResourceIsLocked

string

Granted

string

Invalid

string

PendingAdminDecision

string

PendingApproval

string

PendingApprovalProvisioning

string

PendingEvaluation

string

PendingExternalProvisioning

string

PendingProvisioning

string

PendingRevocation

string

PendingScheduleCreation

string

Provisioned

string

ProvisioningStarted

string

Revoked

string

ScheduleCreated

string

TimedOut

string

TicketInfo

Informations de ticket sur l’éligibilité du rôle

Nom Type Description
ticketNumber

string

Numéro de ticket pour l’éligibilité au rôle

ticketSystem

string

Nom du système de ticket pour l’éligibilité du rôle

Type

Type d’expiration de la planification d’éligibilité des rôles

Nom Type Description
AfterDateTime

string

AfterDuration

string

NoExpiration

string