teamsAsyncOperation リソースの種類teamsAsyncOperation resource type

Microsoft Teams の非同期操作は、1つの API 要求の有効期間を transcends する操作です。A Microsoft Teams async operation is an operation that transcends the lifetime of a single API request. これらの操作は、送信元の要求の時間内に実行するのに時間がかかる場合があります。These operations are long-running or too expensive to complete within the timeframe of their originating request.

Async 操作が開始されると、メソッドは202の受け入れられた応答コードを返します。When an async operation is initiated, the method returns a 202 Accepted response code. また、応答には、teamsAsyncOperation の場所が含まれている場所のヘッダーも含まれます。The response will also contain a Location header, which contains the location of the teamsAsyncOperation. この場所に GET 要求を行うことによって、操作の状態を定期的にチェックします。チェックが終わるまで30秒 >。Periodically check the status of the operation by making a GET request to this location; wait >30 seconds between checks. 要求が正常に完了すると、状態は "succeeded" になり、targetResourceLocation は作成/変更されたリソースを参照するようになります。When the request completes successfully, the status will be "succeeded" and the targetResourceLocation will point to the created/modified resource.

プロパティProperties

プロパティProperty Type 説明Description
idid stringstring 一意の操作 id。Unique operation id.
operationTypeoperationType teamsAsyncOperationTypeteamsAsyncOperationType 説明されている操作の種類を示します。Denotes which type of operation is being described.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 操作が作成された時刻。Time when the operation was created.
statusstatus teamsAsyncOperationStatusteamsAsyncOperationStatus 操作の状態。Operation status.
lastActionDateTimelastActionDateTime DateTimeOffsetDateTimeOffset Async 操作が最後に更新された時刻。Time when the async operation was last updated.
attemptsCountattemptsCount Int32Int32 操作が成功したか失敗したかがマークされるまでの、操作が試行された回数。Number of times the operation was attempted before being marked successful or failed.
targetResourceIdtargetResourceId guidguid この非同期操作の結果として作成または変更されるオブジェクトの ID (通常はチーム)。The ID of the object that's created or modified as result of this async operation, typically a team.
targetResourceLocationtargetResourceLocation stringstring この非同期操作の結果として作成または変更されたオブジェクトの場所。The location of the object that's created or modified as result of this async operation. この URL は、不透明な値として扱われ、そのコンポーネントのパスに解析されることはありません。This URL should be treated as an opaque value and not parsed into its component paths.
errorerror operationErroroperationError 非同期操作が失敗する原因となるエラー。Any error that causes the async operation to fail.

JSON 表記JSON representation

リソースの JSON 表記を次に示します。The following is a JSON representation of the resource.

{
    "id": "string",
    "operationType": "archiveTeam",
    "createdDateTime": "2018-01-01T00:00:00.0000000Z",
    "status": "succeeded",
    "lastActionDateTime": "2018-01-01T00:00:00.0000000Z",
    "attemptsCount": 1,
    "targetResourceId": "fa4aa5a2-a75b-4769-86f4-9e2742a18fda",
    "targetResourceLocation": "/groups('fa4aa5a2-a75b-4769-86f4-9e2742a18fda')/team",
    "error": null
}