Freigeben über


Role Eligibility Schedule Requests - Validate

Überprüft eine neue Berechtigungsplanungsanforderung für Rollen.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
roleEligibilityScheduleRequestName
path True

string

Der Name der zu überprüfenden Rollenberechtigungsanforderung.

scope
path True

string

Der Gültigkeitsbereich der zu überprüfenden Rollenberechtigungsanforderung.

api-version
query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.principalId True

string

Die Prinzipal-ID.

properties.requestType True

RequestType

Der Typ der Rollenzuweisungsplanungsanforderung. Eg: SelfActivate, AdminAssign usw.

properties.roleDefinitionId True

string

Die Rollendefinitions-ID.

properties.condition

string

Die Bedingungen für die Rollenzuweisung. Dadurch werden die Ressourcen beschränkt, denen sie zugewiesen werden können. z. B.: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Version der Bedingung. Der aktuell akzeptierte Wert ist "2,0"

properties.justification

string

Begründung für die Rollenberechtigung

properties.scheduleInfo

ScheduleInfo

Planen von Informationen zum Rollenberechtigungszeitplan

properties.targetRoleEligibilityScheduleId

string

Die resultierende Rollenberechtigungsplanungs-ID oder die Rollenberechtigungsplanungs-ID, die aktualisiert wird

properties.targetRoleEligibilityScheduleInstanceId

string

Die Rollenberechtigungs-Zeitplaninstanz-ID, die aktualisiert wird

properties.ticketInfo

TicketInfo

Ticketinformationen der Rollenberechtigung

Antworten

Name Typ Beschreibung
200 OK

RoleEligibilityScheduleRequest

OK – Gibt Informationen zur Anforderung des Rollenberechtigungszeitplans zurück.

Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

ValidateRoleEligibilityScheduleRequestByName

Beispielanforderung

POST https://management.azure.com/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleEligibilityScheduleRequests/64caffb6-55c0-4deb-a585-68e948ea1ad6/validate?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"
  }
}

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
CloudError

Eine Fehlerantwort des Diensts.

CloudErrorBody

Eine Fehlerantwort des Diensts.

ExpandedProperties

Erweiterte Informationen zu Ressource, Rolle und Prinzipal

Expiration

Ablauf des Rollenberechtigungszeitplans

Principal

Details des Prinzipals

principalType

Der Prinzipaltyp der zugewiesenen Prinzipal-ID.

RequestType

Der Typ der Rollenzuweisungsplanungsanforderung. Eg: SelfActivate, AdminAssign usw.

RoleDefinition

Details zur Rollendefinition

RoleEligibilityScheduleRequest

Rollenberechtigungsplanungsanforderung

ScheduleInfo

Planen von Informationen zum Rollenberechtigungszeitplan

Scope

Details zum Ressourcenbereich

Status

Der Status der Rollenberechtigungsplanungsanforderung.

TicketInfo

Ticketinformationen der Rollenberechtigung

Type

Typ des Ablaufs des Rollenberechtigungszeitplans

CloudError

Eine Fehlerantwort des Diensts.

Name Typ Beschreibung
error

CloudErrorBody

Eine Fehlerantwort des Diensts.

CloudErrorBody

Eine Fehlerantwort des Diensts.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.

message

string

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

ExpandedProperties

Erweiterte Informationen zu Ressource, Rolle und Prinzipal

Name Typ Beschreibung
principal

Principal

Details des Prinzipals

roleDefinition

RoleDefinition

Details zur Rollendefinition

scope

Scope

Details zum Ressourcenbereich

Expiration

Ablauf des Rollenberechtigungszeitplans

Name Typ Beschreibung
duration

string

Dauer des Rollenberechtigungszeitplans in TimeSpan.

endDateTime

string (date-time)

End DateTime des Rollenberechtigungszeitplans.

type

Type

Typ des Ablaufs des Rollenberechtigungszeitplans

Principal

Details des Prinzipals

Name Typ Beschreibung
displayName

string

Anzeigename des Prinzipals

email

string

E-Mail-ID des Prinzipals

id

string

ID des Prinzipals

type

string

Typ des Prinzipals

principalType

Der Prinzipaltyp der zugewiesenen Prinzipal-ID.

Wert Beschreibung
Device
ForeignGroup
Group
ServicePrincipal
User

RequestType

Der Typ der Rollenzuweisungsplanungsanforderung. Eg: SelfActivate, AdminAssign usw.

Wert Beschreibung
AdminAssign
AdminExtend
AdminRemove
AdminRenew
AdminUpdate
SelfActivate
SelfDeactivate
SelfExtend
SelfRenew

RoleDefinition

Details zur Rollendefinition

Name Typ Beschreibung
displayName

string

Anzeigename der Rollendefinition

id

string

ID der Rollendefinition

type

string

Typ der Rollendefinition

RoleEligibilityScheduleRequest

Rollenberechtigungsplanungsanforderung

Name Typ Beschreibung
id

string

Die Anforderungs-ID des Rollenberechtigungszeitplans.

name

string

Der Name des Rollenberechtigungszeitplans.

properties.approvalId

string

Die genehmigungs-ID der Rollenberechtigungsplanungsanforderung.

properties.condition

string

Die Bedingungen für die Rollenzuweisung. Dadurch werden die Ressourcen beschränkt, denen sie zugewiesen werden können. z. B.: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Version der Bedingung. Der aktuell akzeptierte Wert ist "2,0"

properties.createdOn

string (date-time)

DateTime, wann die Rollenberechtigungsplanungsanforderung erstellt wurde

properties.expandedProperties

ExpandedProperties

Zusätzliche Eigenschaften von Prinzipal-, Bereichs- und Rollendefinition

properties.justification

string

Begründung für die Rollenberechtigung

properties.principalId

string

Die Prinzipal-ID.

properties.principalType

principalType

Der Prinzipaltyp der zugewiesenen Prinzipal-ID.

properties.requestType

RequestType

Der Typ der Rollenzuweisungsplanungsanforderung. Eg: SelfActivate, AdminAssign usw.

properties.requestorId

string

ID des Benutzers, der diese Anforderung erstellt hat

properties.roleDefinitionId

string

Die Rollendefinitions-ID.

properties.scheduleInfo

ScheduleInfo

Planen von Informationen zum Rollenberechtigungszeitplan

properties.scope

string

Der Anforderungsbereich des Rollenberechtigungszeitplans.

properties.status

Status

Der Status der Rollenberechtigungsplanungsanforderung.

properties.targetRoleEligibilityScheduleId

string

Die resultierende Rollenberechtigungsplanungs-ID oder die Rollenberechtigungsplanungs-ID, die aktualisiert wird

properties.targetRoleEligibilityScheduleInstanceId

string

Die Rollenberechtigungs-Zeitplaninstanz-ID, die aktualisiert wird

properties.ticketInfo

TicketInfo

Ticketinformationen der Rollenberechtigung

type

string

Der Anforderungstyp des Rollenberechtigungszeitplans.

ScheduleInfo

Planen von Informationen zum Rollenberechtigungszeitplan

Name Typ Beschreibung
expiration

Expiration

Ablauf des Rollenberechtigungszeitplans

startDateTime

string (date-time)

Start DateTime des Rollenberechtigungszeitplans.

Scope

Details zum Ressourcenbereich

Name Typ Beschreibung
displayName

string

Anzeigename der Ressource

id

string

Bereichs-ID der Ressource

type

string

Typ der Ressource

Status

Der Status der Rollenberechtigungsplanungsanforderung.

Wert Beschreibung
Accepted
AdminApproved
AdminDenied
Canceled
Denied
Failed
FailedAsResourceIsLocked
Granted
Invalid
PendingAdminDecision
PendingApproval
PendingApprovalProvisioning
PendingEvaluation
PendingExternalProvisioning
PendingProvisioning
PendingRevocation
PendingScheduleCreation
Provisioned
ProvisioningStarted
Revoked
ScheduleCreated
TimedOut

TicketInfo

Ticketinformationen der Rollenberechtigung

Name Typ Beschreibung
ticketNumber

string

Ticketnummer für die Rollenberechtigung

ticketSystem

string

Name des Ticketsystems für die Rollenberechtigung

Type

Typ des Ablaufs des Rollenberechtigungszeitplans

Wert Beschreibung
AfterDateTime
AfterDuration
NoExpiration