UpdateLocationSmb

SMB ファイルサーバーに接続可能な DataSync エージェント (1 つまたは複数) を指定します。エージェントは、Amazon リソースネーム (ARN) を使用して指定します。

タイプ: 文字列の配列

配列メンバー: 最小数は 1 項目です。最大数は 4 項目です。

長さの制約: 最大長は 128 です。

パターン: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$

必須: いいえ

DataSync が SMB ファイルサーバーへの接続に使用する認証プロトコルを指定します。DataSync は NTLM (デフォルト) とKERBEROS認証をサポートしています。

詳細については、「SMB ファイルサーバーへの DataSync アクセスの提供」を参照してください。

型: 文字列

有効な値：NTLM | KERBEROS

必須：いいえ

SMB ファイルサーバーが属する DNS サーバーの IP アドレス (IPv4 または IPv6) を指定します。このパラメータはAuthenticationType、 が に設定されている場合にのみ適用されますKERBEROS。

環境に複数のドメインがある場合は、このパラメータを設定すると、DataSync が適切な SMB ファイルサーバーに接続されます。

型: 文字列の配列

配列メンバー: 最大数は 2 項目です。

長さの制限: 最小長は 7 です。最大長は 39 です。

パターン: \A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z

必須: いいえ

SMB ファイルサーバーが属する Windows ドメイン名を指定します。このパラメータはAuthenticationType、 が に設定されている場合にのみ適用されますNTLM。

環境内に複数のドメインがある場合、このパラメータを構成することで、DataSync が適切なファイルサーバーに接続できるようになります。

タイプ: 文字列

長さの制約: 最大長は 253 です。

パターン: ^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$

必須: いいえ

Kerberos キーテーブル (keytab) ファイルを指定します。これには、Kerberos プリンシパルと暗号化キー間のマッピングが含まれます。

タスク実行エラーを回避するには、キータブファイルの作成に使用する Kerberos プリンシパルが、 に指定した内容と正確に一致していることを確認してくださいKerberosPrincipal。

タイプ: Base64 でエンコードされたバイナリデータオブジェクト

長さの制約: 最大長は 65,536 です。

必須: いいえ

Kerberos 領域設定を定義する Kerberos 設定ファイル (krb5.conf) を指定します。

ファイルは base64 でエンコードされている必要があります。を使用している場合は AWS CLI、エンコードが自動的に行われます。

タイプ: Base64 でエンコードされたバイナリデータオブジェクト

長さの制約: 最大長は 131,072 です。

必須: いいえ

Kerberos プリンシパルを指定します。これは、SMB ファイルサーバーのファイル、フォルダ、ファイルメタデータにアクセスするアクセス許可を持つ Kerberos 領域内のアイデンティティです。

Kerberos プリンシパルは のようになりますHOST/kerberosuser@MYDOMAIN.ORG。

プリンシパル名では大文字と小文字が区別されます。このパラメータに指定したプリンシパルが、キータブファイルの作成に使用するプリンシパルと完全に一致しない場合、DataSync タスクの実行は失敗します。

タイプ: 文字列

長さの制約: 最小長は 1 です。最大長は 256 です。

パターン: ^.+$

必須: いいえ

更新する SMB の場所の ARN を指定します。

タイプ: 文字列

長さの制約: 最大長は 128 です。

パターン: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$

必須: はい

が SMB ファイルサーバーにアクセス AWS DataSync するために使用するサーバーメッセージブロック (SMB) プロトコルのバージョンを指定します。

型: SmbMountOptions オブジェクト

必須: いいえ

SMB ファイルサーバーをマウントでき、転送するファイルとフォルダにアクセスできるユーザーのパスワード。このパラメータはAuthenticationType、 が に設定されている場合にのみ適用されますNTLM。

タイプ: 文字列

長さの制約: 最大長は 104 です。

パターン: ^.{0,104}$

必須: いいえ

DataSync エージェントが接続する SMB ファイルサーバーのドメイン名または IP アドレス (IPv4 または IPv6) を指定します。

タイプ: 文字列

長さの制約: 最大長は 255 です。

パターン: ^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$

必須: いいえ

DataSync がデータを読み書記する SMB ファイルサーバーによってエクスポートされる共有の名前を指定します。共有パスにはサブディレクトリ (例: /path/to/subdirectory) を含めることができます。ネットワーク内の他の SMB クライアントもこのパスをマウントできることを確認してください。

指定したサブディレクトリ内のすべてのデータをコピーするには、DataSync が SMB 共有をマウントして、そのすべてのデータにアクセスできる必要があります。詳細については、「SMB ファイルサーバーへの DataSync アクセスの提供」を参照してください。

タイプ: 文字列

長さの制約: 最大長は 4,096 です。

パターン: ^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

必須: いいえ

SMB ファイルサーバーをマウントでき、転送に関係するファイルやフォルダにアクセスする権限を持つユーザー名を指定します。このパラメータはAuthenticationType、 が に設定されている場合にのみ適用されますNTLM。

転送に適したレベルのアクセスを持つユーザーを選択する方法については、「SMB ファイルサーバーへの DataSync アクセスの提供」を参照してください。

タイプ: 文字列

長さの制約: 最大長は 104 です。

パターン: ^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$

必須: いいえ

この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。

HTTP ステータスコード: 500

この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。

HTTP ステータスコード: 400