Share via


Role Eligibility Schedule Requests - Validate

Überprüft eine neue Anforderung für die Rollenberechtigung.

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 Bereich der zu überprüfenden Rollenberechtigungsanforderung.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.principalId True

string

Die Prinzipal-ID.

properties.requestType True

RequestType

Der Typ der Anforderung des Rollenzuweisungszeitplans. Z. B. SelfActivate, AdminAssign usw.

properties.roleDefinitionId True

string

Hierbei handelt es sich um die Rollendefinitions-ID.

properties.condition

string

Die Bedingungen für die Rollenzuweisung. Dies schränkt die Ressourcen ein, denen sie zugewiesen werden kann. Beispiel: @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 Rollenberechtigungszeitplan-ID oder die Rollenberechtigungszeitplan-ID, die aktualisiert wird

properties.targetRoleEligibilityScheduleInstanceId

string

Der Rollenberechtigungsplan instance ID, die aktualisiert wird

properties.ticketInfo

TicketInfo

Ticketinformationen zur Rollenberechtigung

Antworten

Name Typ Beschreibung
200 OK

RoleEligibilityScheduleRequest

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

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

ValidateRoleEligibilityScheduleRequestByName

Sample Request

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

Sample Response

{
  "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 vom Dienst.

CloudErrorBody

Eine Fehlerantwort vom Dienst.

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 Anforderung des Rollenzuweisungszeitplans. Z. B. SelfActivate, AdminAssign usw.

RoleDefinition

Details zur Rollendefinition

RoleEligibilityScheduleRequest

Anforderung des Rollenberechtigungszeitplans

ScheduleInfo

Planen von Informationen zum Rollenberechtigungszeitplan

Scope

Details zum Ressourcenbereich

Status

Die status der Anforderung zum Rollenberechtigungszeitplan.

TicketInfo

Ticketinformationen zur Rollenberechtigung

Type

Typ des Ablaufplans für die Rollenberechtigung

CloudError

Eine Fehlerantwort vom Dienst.

Name Typ Beschreibung
error

CloudErrorBody

Eine Fehlerantwort vom Dienst.

CloudErrorBody

Eine Fehlerantwort vom Dienst.

Name Typ Beschreibung
code

string

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

message

string

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

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 Zeitplans für die Rollenberechtigung in TimeSpan.

endDateTime

string

End DateTime des Rollenberechtigungszeitplans.

type

Type

Typ des Ablaufplans für die Rollenberechtigung

Principal

Details des Prinzipals

Name Typ Beschreibung
displayName

string

Anzeigename des Prinzipals

email

string

Email ID des Prinzipals

id

string

ID des Prinzipals

type

string

Typ des Prinzipals

principalType

Der Prinzipaltyp der zugewiesenen Prinzipal-ID.

Name Typ Beschreibung
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RequestType

Der Typ der Anforderung des Rollenzuweisungszeitplans. Z. B. SelfActivate, AdminAssign usw.

Name Typ Beschreibung
AdminAssign

string

AdminExtend

string

AdminRemove

string

AdminRenew

string

AdminUpdate

string

SelfActivate

string

SelfDeactivate

string

SelfExtend

string

SelfRenew

string

RoleDefinition

Details zur Rollendefinition

Name Typ Beschreibung
displayName

string

Anzeigename der Rollendefinition

id

string

ID der Rollendefinition

type

string

Typ der Rollendefinition

RoleEligibilityScheduleRequest

Anforderung des Rollenberechtigungszeitplans

Name Typ Beschreibung
id

string

Die Anforderungs-ID des Rollenberechtigungszeitplans.

name

string

Der Anforderungsname des Rollenberechtigungszeitplans.

properties.approvalId

string

Die approvalId der Anforderung des Rollenberechtigungszeitplans.

properties.condition

string

Die Bedingungen für die Rollenzuweisung. Dies schränkt die Ressourcen ein, denen sie zugewiesen werden kann. Beispiel: @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

DateTime, wenn die Anforderung des Rollenberechtigungszeitplans erstellt wurde

properties.expandedProperties

ExpandedProperties

Zusätzliche Eigenschaften der 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 Anforderung des Rollenzuweisungszeitplans. Z. B. SelfActivate, AdminAssign usw.

properties.requestorId

string

ID des Benutzers, der diese Anforderung erstellt hat

properties.roleDefinitionId

string

Hierbei handelt es sich um die Rollendefinitions-ID.

properties.scheduleInfo

ScheduleInfo

Planen von Informationen zum Rollenberechtigungszeitplan

properties.scope

string

Der Anforderungsbereich des Rollenberechtigungszeitplans.

properties.status

Status

Die status der Anforderung zum Rollenberechtigungszeitplan.

properties.targetRoleEligibilityScheduleId

string

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

properties.targetRoleEligibilityScheduleInstanceId

string

Der Rollenberechtigungsplan instance ID, die aktualisiert wird

properties.ticketInfo

TicketInfo

Ticketinformationen zur Rollenberechtigung

type

string

Der Anforderungstyp des Rollenberechtigungszeitplans.

ScheduleInfo

Planen von Informationen zum Rollenberechtigungszeitplan

Name Typ Beschreibung
expiration

Expiration

Ablauf des Rollenberechtigungszeitplans

startDateTime

string

Starten Sie 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

Die status der Anforderung zum Rollenberechtigungszeitplan.

Name Typ Beschreibung
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

Ticketinformationen zur Rollenberechtigung

Name Typ Beschreibung
ticketNumber

string

Ticketnummer für die Rollenberechtigung

ticketSystem

string

Name des Ticketsystems für die Rollenberechtigung

Type

Typ des Ablaufplans für die Rollenberechtigung

Name Typ Beschreibung
AfterDateTime

string

AfterDuration

string

NoExpiration

string