Invitations - Create

공유에 액세스하기 위해 받는 사람에게 새 초대를 보냅니다.
초대 만들기

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations/{invitationName}?api-version=2021-08-01

URI 매개 변수

Name In Required Type Description
accountName
path True
  • string

공유 계정의 이름입니다.

invitationName
path True
  • string

초대의 이름입니다.

resourceGroupName
path True
  • string

리소스 그룹 이름입니다.

shareName
path True
  • string

초대를 보낼 공유의 이름입니다.

subscriptionId
path True
  • string

구독 식별자

api-version
query True
  • string

사용할 API 버전입니다.

요청 본문

Name Type Description
properties.expirationDate
  • string

초대 및 공유 구독의 만료 날짜입니다.

properties.targetActiveDirectoryId
  • string

대상 Azure AD ID입니다. 전자 메일과 결합할 수 없습니다.

properties.targetEmail
  • string

초대가 전달되는 전자 메일입니다.

properties.targetObjectId
  • string

초대를 보내는 대상 사용자 또는 애플리케이션 ID입니다. TargetActiveDirectoryId를 따라 지정해야 합니다. 이렇게 하면 AD 테넌트에서 특정 사용자 또는 애플리케이션에 초대를 보낼 수 있습니다.

응답

Name Type Description
200 OK

성공

201 Created

성공

Other Status Codes

Microsoft.DataShare 리소스 공급자로부터 받은 오류 응답입니다.

보안

azure_auth

OAuth2 Flow Azure Active Directory.

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

Invitations_Create

Sample Request

PUT https://management.azure.com/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1/shares/Share1/invitations/Invitation1?api-version=2021-08-01

{
  "properties": {
    "targetEmail": "receiver@microsoft.com",
    "expirationDate": "2020-08-26T22:33:24.5785265Z"
  }
}

Sample Response

Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-tenant-reads: 14999
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd
{
  "properties": {
    "userName": "John Smith",
    "sentAt": "2018-11-26T22:33:24.5785265Z",
    "targetEmail": "receiver@microsoft.com",
    "respondedAt": null,
    "invitationStatus": "Pending",
    "userEmail": "johnsmith@microsoft.com",
    "expirationDate": "2020-08-26T22:33:24.5785265Z"
  },
  "id": "/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1/shares/Share1/invitations/Invitation1",
  "name": "Invitation1",
  "type": "Microsoft.DataShare/accounts/shares/invitations"
}
Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-tenant-reads: 14999
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd
{
  "properties": {
    "userName": "John Smith",
    "sentAt": "2018-11-26T22:33:24.5785265Z",
    "targetEmail": "receiver@microsoft.com",
    "respondedAt": null,
    "invitationStatus": "Pending",
    "userEmail": "johnsmith@microsoft.com",
    "expirationDate": "2020-08-26T22:33:24.5785265Z"
  },
  "id": "/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1/shares/Share1/invitations/Invitation1",
  "name": "Invitation1",
  "type": "Microsoft.DataShare/accounts/shares/invitations"
}

정의

createdByType

리소스를 만든 ID의 형식입니다.

DataShareError

데이터 공유 오류 모델입니다.

DataShareErrorInfo

데이터 공유 오류 본문 모델입니다.

Invitation

초대 데이터 전송 개체입니다.

invitationStatus

초대의 상태입니다.

lastModifiedByType

리소스를 마지막으로 수정한 ID의 형식입니다.

SystemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

createdByType

리소스를 만든 ID의 형식입니다.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DataShareError

데이터 공유 오류 모델입니다.

Name Type Description
error

데이터 공유 오류 본문

DataShareErrorInfo

데이터 공유 오류 본문 모델입니다.

Name Type Description
code
  • string

오류 코드

details

오류 모델의 중첩된 세부 정보

message
  • string

오류 메시지

target
  • string

오류의 대상

Invitation

초대 데이터 전송 개체입니다.

Name Type Description
id
  • string

Azure 리소스의 리소스 ID

name
  • string

Azure 리소스의 이름

properties.expirationDate
  • string

초대 및 공유 구독의 만료 날짜입니다.

properties.invitationId
  • string

고유 초대 ID

properties.invitationStatus

초대의 상태입니다.

properties.respondedAt
  • string

받는 사람이 초대에 응답한 시간입니다.

properties.sentAt
  • string

초대가 전송된 시간을 가져옵니다.

properties.targetActiveDirectoryId
  • string

대상 Azure AD ID입니다. 전자 메일과 결합할 수 없습니다.

properties.targetEmail
  • string

초대가 전달되는 전자 메일입니다.

properties.targetObjectId
  • string

초대를 보내는 대상 사용자 또는 애플리케이션 ID입니다. TargetActiveDirectoryId를 따라 지정해야 합니다. 이렇게 하면 AD 테넌트에서 특정 사용자 또는 애플리케이션에 초대를 보낼 수 있습니다.

properties.userEmail
  • string

리소스를 만든 사용자의 이메일

properties.userName
  • string

리소스를 만든 사용자의 이름

systemData

Azure 리소스의 시스템 데이터입니다.

type
  • string

Azure 리소스의 유형

invitationStatus

초대의 상태입니다.

Name Type Description
Accepted
  • string
Pending
  • string
Rejected
  • string
Withdrawn
  • string

lastModifiedByType

리소스를 마지막으로 수정한 ID의 형식입니다.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

SystemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name Type Description
createdAt
  • string

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy
  • string

리소스를 만든 ID입니다.

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt
  • string

리소스를 마지막으로 수정한 ID의 형식입니다.

lastModifiedBy
  • string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

리소스를 마지막으로 수정한 ID의 형식입니다.