Dela via


Role Eligibility Schedule Requests - Validate

Validerar en ny begäran om behörighetsschema för rollen.

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

URI-parametrar

Name I Obligatorisk Typ Description
roleEligibilityScheduleRequestName
path True

string

Namnet på den rollberättigande begäran som ska verifieras.

scope
path True

string

Omfånget för rollberättigandebegäran som ska valideras.

api-version
query True

string

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Obligatorisk Typ Description
properties.principalId True

string

Huvud-ID:t.

properties.requestType True

RequestType

Typ av begäran om rolltilldelningsschema. T.ex. SelfActivate, AdminAssign osv.

properties.roleDefinitionId True

string

Rolldefinitions-ID.

properties.condition

string

Villkoren för rolltilldelningen. Detta begränsar de resurser som den kan tilldelas till. t.ex. @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase "foo_storage_container"

properties.conditionVersion

string

Version av villkoret. För närvarande accepteras värdet "2.0"

properties.justification

string

Motivering för rollens berättigande

properties.scheduleInfo

ScheduleInfo

Schemalägg information om behörighetsschemat för rollen

properties.targetRoleEligibilityScheduleId

string

Det resulterande schema-ID:t för rollberättigande eller det schema-ID för rollberättigande som uppdateras

properties.targetRoleEligibilityScheduleInstanceId

string

Schemalägg instans-ID för rollberättigande som uppdateras

properties.ticketInfo

TicketInfo

Biljettinformation för rollens berättigande

Svar

Name Typ Description
200 OK

RoleEligibilityScheduleRequest

OK – Returnerar information om begäran om schema för rollberättigande.

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

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

Definitioner

Name Description
CloudError

Ett felsvar från tjänsten.

CloudErrorBody

Ett felsvar från tjänsten.

ExpandedProperties

Utökad information om resurs, roll och huvudnamn

Expiration

Förfallodatum för behörighetsschemat för rollen

Principal

Information om huvudkontot

principalType

Huvudtypen för det tilldelade huvudnamns-ID:t.

RequestType

Typ av begäran om rolltilldelningsschema. T.ex. SelfActivate, AdminAssign osv.

RoleDefinition

Information om rolldefinition

RoleEligibilityScheduleRequest

Begäran om schema för rollberättigande

ScheduleInfo

Schemalägg information om behörighetsschemat för rollen

Scope

Information om resursomfånget

Status

Status för begäran om behörighetsschema för rollen.

TicketInfo

Biljettinformation för rollens berättigande

Type

Typ av förfallodatum för rollberättigandeschemat

CloudError

Ett felsvar från tjänsten.

Name Typ Description
error

CloudErrorBody

Ett felsvar från tjänsten.

CloudErrorBody

Ett felsvar från tjänsten.

Name Typ Description
code

string

En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.

message

string

Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.

ExpandedProperties

Utökad information om resurs, roll och huvudnamn

Name Typ Description
principal

Principal

Information om huvudkontot

roleDefinition

RoleDefinition

Information om rolldefinition

scope

Scope

Information om resursomfånget

Expiration

Förfallodatum för behörighetsschemat för rollen

Name Typ Description
duration

string

Varaktighet för behörighetsschemat för rollen i TimeSpan.

endDateTime

string

SlutdatumTid för behörighetsschemat för rollen.

type

Type

Typ av förfallodatum för rollberättigandeschemat

Principal

Information om huvudkontot

Name Typ Description
displayName

string

Huvudnamnets visningsnamn

email

string

Email ID för huvudkontot

id

string

ID för huvudkontot

type

string

Typ av huvudnamn

principalType

Huvudtypen för det tilldelade huvudnamns-ID:t.

Name Typ Description
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RequestType

Typ av begäran om rolltilldelningsschema. T.ex. SelfActivate, AdminAssign osv.

Name Typ Description
AdminAssign

string

AdminExtend

string

AdminRemove

string

AdminRenew

string

AdminUpdate

string

SelfActivate

string

SelfDeactivate

string

SelfExtend

string

SelfRenew

string

RoleDefinition

Information om rolldefinition

Name Typ Description
displayName

string

Visningsnamn för rolldefinitionen

id

string

ID för rolldefinitionen

type

string

Typ av rolldefinition

RoleEligibilityScheduleRequest

Begäran om schema för rollberättigande

Name Typ Description
id

string

Begärans-ID för schemaläggning av rollberättigande.

name

string

Namnet på begäran om programbegäran för rollberättigande.

properties.approvalId

string

ApprovalId för begäran om behörighetsschema för rollen.

properties.condition

string

Villkoren för rolltilldelningen. Detta begränsar de resurser som den kan tilldelas till. t.ex. @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase "foo_storage_container"

properties.conditionVersion

string

Version av villkoret. För närvarande accepteras värdet "2.0"

properties.createdOn

string

DateTime när begäran om schema för rollberättigande skapades

properties.expandedProperties

ExpandedProperties

Ytterligare egenskaper för huvudnamn, omfång och rolldefinition

properties.justification

string

Motivering för rollens berättigande

properties.principalId

string

Huvud-ID:t.

properties.principalType

principalType

Huvudtypen för det tilldelade huvudnamns-ID:t.

properties.requestType

RequestType

Typ av begäran om rolltilldelningsschema. T.ex. SelfActivate, AdminAssign osv.

properties.requestorId

string

ID för användaren som skapade den här begäran

properties.roleDefinitionId

string

Rolldefinitions-ID.

properties.scheduleInfo

ScheduleInfo

Schemalägg information om behörighetsschemat för rollen

properties.scope

string

Rollberättigande schemalägger omfånget för begäran.

properties.status

Status

Status för begäran om behörighetsschema för rollen.

properties.targetRoleEligibilityScheduleId

string

Det resulterande schema-ID:t för rollberättigande eller det schema-ID för rollberättigande som uppdateras

properties.targetRoleEligibilityScheduleInstanceId

string

Schemalägg instans-ID för rollberättigande som uppdateras

properties.ticketInfo

TicketInfo

Biljettinformation för rollens berättigande

type

string

Typ av begäran om schema för rollberättigande.

ScheduleInfo

Schemalägg information om behörighetsschemat för rollen

Name Typ Description
expiration

Expiration

Förfallodatum för behörighetsschemat för rollen

startDateTime

string

Starta DateTime för behörighetsschemat för rollen.

Scope

Information om resursomfånget

Name Typ Description
displayName

string

Resursens visningsnamn

id

string

Resursens omfångs-ID

type

string

Resurstyp

Status

Status för begäran om behörighetsschema för rollen.

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

Biljettinformation för rollens berättigande

Name Typ Description
ticketNumber

string

Biljettnummer för rollens berättigande

ticketSystem

string

Biljettsystemnamn för rollens berättigande

Type

Typ av förfallodatum för rollberättigandeschemat

Name Typ Description
AfterDateTime

string

AfterDuration

string

NoExpiration

string