リソース: TransferOperation
転送の実行についての説明。
JSON 表現 |
---|
{ "name": string, "projectId": string, "transferSpec": { object ( |
フィールド | |
---|---|
name |
システムによって割り当てられたグローバルに一意の ID。 |
projectId |
オペレーションを所有する Google Cloud プロジェクトの ID。 |
transferSpec |
転送仕様。 |
notificationConfig |
通知の構成。 |
loggingConfig |
Cloud Logging の構成。 |
startTime |
この転送の実行の開始時刻。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
endTime |
この転送の実行の終了時刻。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
status |
転送オペレーションのステータス。 |
counters |
転送オペレーションの進行状況に関する情報。 |
errorBreakdowns[] |
サンプル エラーログエントリで発生したエラーの概要を表示します。 |
transferJobName |
この転送オペレーションをトリガーする転送ジョブの名前。 |
ステータス
TransferOperation のステータス。
列挙型 | |
---|---|
STATUS_UNSPECIFIED |
ゼロは無効な値です。 |
IN_PROGRESS |
進行中です。 |
PAUSED |
一時停止しました。 |
SUCCESS |
正常に完了しました。 |
FAILED |
回復不能なエラーのため終了しました。 |
ABORTED |
ユーザーによって中止されました。 |
QUEUED |
システムにより一時的に遅延しています。ユーザーによる対応は必要ありません。 |
SUSPENDING |
オペレーションが停止し、進行中の処理が完了するまでドレインされます。 |
TransferCounters
転送操作の進行状況を報告するカウンターのコレクション。
JSON 表現 |
---|
{ "objectsFoundFromSource": string, "bytesFoundFromSource": string, "objectsFoundOnlyFromSink": string, "bytesFoundOnlyFromSink": string, "objectsFromSourceSkippedBySync": string, "bytesFromSourceSkippedBySync": string, "objectsCopiedToSink": string, "bytesCopiedToSink": string, "objectsDeletedFromSource": string, "bytesDeletedFromSource": string, "objectsDeletedFromSink": string, "bytesDeletedFromSink": string, "objectsFromSourceFailed": string, "bytesFromSourceFailed": string, "objectsFailedToDeleteFromSink": string, "bytesFailedToDeleteFromSink": string, "directoriesFoundFromSource": string, "directoriesFailedToListFromSource": string, "directoriesSuccessfullyListedFromSource": string, "intermediateObjectsCleanedUp": string, "intermediateObjectsFailedCleanedUp": string } |
フィールド | |
---|---|
objectsFoundFromSource |
転送がスケジュールされているデータソース内のオブジェクト(オブジェクトの条件に基づいてフィルタリングされたオブジェクトや、同期によってスキップされたオブジェクトは除く)。 |
bytesFoundFromSource |
転送がスケジュールされているデータソース内のバイト数(オブジェクトの条件に基づいてフィルタリングされたバイト数や、同期によってスキップされたバイト数は除く)。 |
objectsFoundOnlyFromSink |
データシンク内にのみ存在し、削除がスケジュールされているオブジェクト。 |
bytesFoundOnlyFromSink |
データシンク内にあるのみで、削除がスケジュールされているバイト数。 |
objectsFromSourceSkippedBySync |
データシンクにすでに存在しているため、転送されないデータソース内のオブジェクト。 |
bytesFromSourceSkippedBySync |
データソースのバイトのうち、データシンクにすでに存在しているため転送されないもの。 |
objectsCopiedToSink |
データシンクにコピーされるオブジェクト。 |
bytesCopiedToSink |
データシンクにコピーされるバイト数。 |
objectsDeletedFromSource |
データソースから削除されたオブジェクト。 |
bytesDeletedFromSource |
データソースから削除されたバイト数。 |
objectsDeletedFromSink |
データシンクから削除されるオブジェクト。 |
bytesDeletedFromSink |
データシンクから削除されたバイト数。 |
objectsFromSourceFailed |
転送に失敗した、または転送後に削除できなかったデータソース内のオブジェクト。 |
bytesFromSourceFailed |
転送できなかった、または転送後に削除できなかったデータソースのバイト数。 |
objectsFailedToDeleteFromSink |
データシンクから削除できなかったオブジェクト。 |
bytesFailedToDeleteFromSink |
データシンクから削除できなかったバイト数。 |
directoriesFoundFromSource |
PosixFilesystem を含む転送にのみ使用します。 リスト取得中に見つかったディレクトリの数。たとえば、転送のルート ディレクトリが |
directoriesFailedToListFromSource |
PosixFilesystem を含む転送にのみ使用します。 ソースで検出された各ディレクトリのリスト失敗数。ディレクトリのリスト時に発生する可能性のある障害には、権限エラーやブロックエラーなどがあります。ディレクトリの一覧表示が失敗した場合、ディレクトリ内のファイルは転送されません。 |
directoriesSuccessfullyListedFromSource |
PosixFilesystem を含む転送にのみ使用します。 ソースで検出された各ディレクトリの正常なリスティング数。 |
intermediateObjectsCleanedUp |
正常にクリーンアップされた中間オブジェクトの数。 |
intermediateObjectsFailedCleanedUp |
クリーンアップに失敗した中間オブジェクトの数。 |
ErrorSummary
エラーコード、数、サンプルエラーのログエントリによるエラーの概要。
JSON 表現 |
---|
{ "errorCode": enum ( |
フィールド | |
---|---|
errorCode |
必須。 |
errorCount |
必須。このタイプのエラーの数。 |
errorLogEntries[] |
エラーサンプル。 1 回の転送オペレーションで、特定のエラーコードに対して最大 5 つのエラーログ エントリが記録されます。 |
コード
Google API の正規エラーコード。
列挙型 | |
---|---|
OK |
エラーではありません。成功したときに返されます。 HTTP マッピング: 200 OK |
CANCELLED |
オペレーションがキャンセルされました。通常、キャンセルは呼び出し元により行われます。 HTTP マッピング: 499 クライアントのクローズ リクエスト |
UNKNOWN |
不明なエラーです。たとえば、別のアドレス空間から受信した HTTP マッピング: 500 内部サーバーエラー |
INVALID_ARGUMENT |
クライアントが無効な引数を指定しました。これは HTTP マッピング: 400 不正なリクエスト |
DEADLINE_EXCEEDED |
オペレーションが完了する前に期限が切れました。システムの状態を変更するオペレーションの場合、オペレーションが正常に終了しても、このエラーが返されることがあります。たとえば、サーバーからの正常なレスポンスが期限切れになるほど遅延する場合もあります。 HTTP マッピング: 504 ゲートウェイ タイムアウト |
NOT_FOUND |
一部のリクエストされたエンティティ(ファイルやディレクトリなど)が見つかりませんでした。 サーバー デベロッパーへの注: 段階的な機能のロールアウトや文書化されていない許可リストなど、ユーザークラス全体に対してリクエストが拒否された場合は、 HTTP マッピング: 404 見つかりません |
ALREADY_EXISTS |
クライアントが作成しようとしたエンティティ(ファイルまたはディレクトリなど)はすでに存在しています。 HTTP マッピング: 409 競合 |
PERMISSION_DENIED |
呼び出し元には、指定されたオペレーションを実行する権限がありません。 HTTP マッピング: 403 禁止です |
UNAUTHENTICATED |
リクエストにはオペレーションに有効な認証情報がありません。 HTTP マッピング: 401 権限なし |
RESOURCE_EXHAUSTED |
ユーザーごとの割り当て、またはファイル システム全体で容量が不足しているため、一部のリソースが枯渇しています。 HTTP マッピング: 429 リクエストが多すぎます |
FAILED_PRECONDITION |
システムがオペレーションの実行に必要な状態ではないため、オペレーションが拒否されました。たとえば、削除されるディレクトリが空でない、rmdir オペレーションがディレクトリ以外に適用されているなどの状態です。 サービスの実装者は、次のガイドラインを使用して、 HTTP マッピング: 400 不正なリクエスト |
ABORTED |
オペレーションは、通常、シーケンサー チェックの失敗、またはトランザクションの中止などの同時実行の問題のために中止されています。
HTTP マッピング: 409 競合 |
OUT_OF_RANGE |
オペレーションが有効な範囲を超えて試行されました。たとえば、ファイルの終わりを超えたシークまたは読み取りなどが該当します。
HTTP マッピング: 400 不正なリクエスト |
UNIMPLEMENTED |
オペレーションが実装されていないか、このサービスでサポートまたは有効にされていません。 HTTP マッピング: 501 実装されていません |
INTERNAL |
内部エラー。これは、基盤となるシステムで予期される一部の不変条件が満たされていないことを意味します。このエラーコードは深刻なエラーのために予約されています。 HTTP マッピング: 500 内部サーバーエラー |
UNAVAILABLE |
サービスは現在使用できません。これは、バックオフで再試行することで解決できる可能性が高い一時的な状態です。非べき等オペレーションの再試行が常に安全であるとは限りません。
HTTP マッピング: 503 サービスを利用できません |
DATA_LOSS |
回復不能なデータの消失や破損。 「HTTP Mapping: 500 Internal Server Error」(HTTP マッピング: 500 内部サーバーエラー) |
ErrorLogEntry
発生したエラーを説明するエントリ。
JSON 表現 |
---|
{ "url": string, "errorDetails": [ string ] } |
フィールド | |
---|---|
url |
必須。エラーが関連付けられているターゲット(データソース、データシンク、オブジェクト)を参照する URL。 |
errorDetails[] |
エラーの詳細を保持するメッセージのリスト。 |
メソッド |
|
---|---|
|
転送をキャンセルします。 |
|
長時間実行オペレーションの最新状態を取得します。 |
|
転送オペレーションを一覧表示します。 |
|
転送操作を一時停止します。 |
|
一時停止されていた転送操作を再開します。 |