DataSyncClient#
Auto-generated documentation for DataSync type annotations stubs module mypy-boto3-datasync.
DataSyncClient#
Type annotations and code completion for boto3.client("datasync")
.
boto3 documentation
# DataSyncClient usage example
from boto3.session import Session
from mypy_boto3_datasync.client import DataSyncClient
def get_datasync_client() -> DataSyncClient:
return Session().client("datasync")
Exceptions#
boto3
client exceptions are generated in runtime.
This class provides code completion for boto3.client("datasync").exceptions
structure.
# Exceptions.exceptions usage example
client = boto3.client("datasync")
try:
do_something(client)
except (
client.exceptions.ClientError,
client.exceptions.InternalException,
client.exceptions.InvalidRequestException,
) as e:
print(e)
# Exceptions.exceptions type checking example
from mypy_boto3_datasync.client import Exceptions
def handle_error(exc: Exceptions.ClientError) -> None:
...
Methods#
add_storage_system#
Creates an Amazon Web Services resource for an on-premises storage system that you want DataSync Discovery to collect information about.
Type annotations and code completion for boto3.client("datasync").add_storage_system
method.
boto3 documentation
# add_storage_system method definition
def add_storage_system(
self,
*,
ServerConfiguration: DiscoveryServerConfigurationTypeDef, # (1)
SystemType: DiscoverySystemTypeType, # (2)
AgentArns: Sequence[str],
ClientToken: str,
Credentials: CredentialsTypeDef, # (3)
CloudWatchLogGroupArn: str = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (4)
Name: str = ...,
) -> AddStorageSystemResponseTypeDef: # (5)
...
- See DiscoveryServerConfigurationTypeDef
- See DiscoverySystemTypeType
- See CredentialsTypeDef
- See TagListEntryTypeDef
- See AddStorageSystemResponseTypeDef
# add_storage_system method usage example with argument unpacking
kwargs: AddStorageSystemRequestRequestTypeDef = { # (1)
"ServerConfiguration": ...,
"SystemType": ...,
"AgentArns": ...,
"ClientToken": ...,
"Credentials": ...,
}
parent.add_storage_system(**kwargs)
can_paginate#
Check if an operation can be paginated.
Type annotations and code completion for boto3.client("datasync").can_paginate
method.
boto3 documentation
# can_paginate method definition
def can_paginate(
self,
operation_name: str,
) -> bool:
...
cancel_task_execution#
Stops an DataSync task execution that's in progress.
Type annotations and code completion for boto3.client("datasync").cancel_task_execution
method.
boto3 documentation
# cancel_task_execution method definition
def cancel_task_execution(
self,
*,
TaskExecutionArn: str,
) -> Dict[str, Any]:
...
# cancel_task_execution method usage example with argument unpacking
kwargs: CancelTaskExecutionRequestRequestTypeDef = { # (1)
"TaskExecutionArn": ...,
}
parent.cancel_task_execution(**kwargs)
close#
Closes underlying endpoint connections.
Type annotations and code completion for boto3.client("datasync").close
method.
boto3 documentation
# close method definition
def close(
self,
) -> None:
...
create_agent#
Activates an DataSync agent that you deploy in your storage environment.
Type annotations and code completion for boto3.client("datasync").create_agent
method.
boto3 documentation
# create_agent method definition
def create_agent(
self,
*,
ActivationKey: str,
AgentName: str = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (1)
VpcEndpointId: str = ...,
SubnetArns: Sequence[str] = ...,
SecurityGroupArns: Sequence[str] = ...,
) -> CreateAgentResponseTypeDef: # (2)
...
# create_agent method usage example with argument unpacking
kwargs: CreateAgentRequestRequestTypeDef = { # (1)
"ActivationKey": ...,
}
parent.create_agent(**kwargs)
create_location_azure_blob#
Creates a transfer location for a Microsoft Azure Blob Storage container.
Type annotations and code completion for boto3.client("datasync").create_location_azure_blob
method.
boto3 documentation
# create_location_azure_blob method definition
def create_location_azure_blob(
self,
*,
ContainerUrl: str,
AuthenticationType: AzureBlobAuthenticationTypeType, # (1)
AgentArns: Sequence[str],
SasConfiguration: AzureBlobSasConfigurationTypeDef = ..., # (2)
BlobType: AzureBlobTypeType = ..., # (3)
AccessTier: AzureAccessTierType = ..., # (4)
Subdirectory: str = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (5)
) -> CreateLocationAzureBlobResponseTypeDef: # (6)
...
- See AzureBlobAuthenticationTypeType
- See AzureBlobSasConfigurationTypeDef
- See AzureBlobTypeType
- See AzureAccessTierType
- See TagListEntryTypeDef
- See CreateLocationAzureBlobResponseTypeDef
# create_location_azure_blob method usage example with argument unpacking
kwargs: CreateLocationAzureBlobRequestRequestTypeDef = { # (1)
"ContainerUrl": ...,
"AuthenticationType": ...,
"AgentArns": ...,
}
parent.create_location_azure_blob(**kwargs)
create_location_efs#
Creates a transfer location for an Amazon EFS file system.
Type annotations and code completion for boto3.client("datasync").create_location_efs
method.
boto3 documentation
# create_location_efs method definition
def create_location_efs(
self,
*,
EfsFilesystemArn: str,
Ec2Config: Ec2ConfigTypeDef, # (1)
Subdirectory: str = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (2)
AccessPointArn: str = ...,
FileSystemAccessRoleArn: str = ...,
InTransitEncryption: EfsInTransitEncryptionType = ..., # (3)
) -> CreateLocationEfsResponseTypeDef: # (4)
...
- See Ec2ConfigTypeDef
- See TagListEntryTypeDef
- See EfsInTransitEncryptionType
- See CreateLocationEfsResponseTypeDef
# create_location_efs method usage example with argument unpacking
kwargs: CreateLocationEfsRequestRequestTypeDef = { # (1)
"EfsFilesystemArn": ...,
"Ec2Config": ...,
}
parent.create_location_efs(**kwargs)
create_location_fsx_lustre#
Creates a transfer location for an Amazon FSx for Lustre file system.
Type annotations and code completion for boto3.client("datasync").create_location_fsx_lustre
method.
boto3 documentation
# create_location_fsx_lustre method definition
def create_location_fsx_lustre(
self,
*,
FsxFilesystemArn: str,
SecurityGroupArns: Sequence[str],
Subdirectory: str = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (1)
) -> CreateLocationFsxLustreResponseTypeDef: # (2)
...
# create_location_fsx_lustre method usage example with argument unpacking
kwargs: CreateLocationFsxLustreRequestRequestTypeDef = { # (1)
"FsxFilesystemArn": ...,
"SecurityGroupArns": ...,
}
parent.create_location_fsx_lustre(**kwargs)
create_location_fsx_ontap#
Creates a transfer location for an Amazon FSx for NetApp ONTAP file system.
Type annotations and code completion for boto3.client("datasync").create_location_fsx_ontap
method.
boto3 documentation
# create_location_fsx_ontap method definition
def create_location_fsx_ontap(
self,
*,
Protocol: FsxProtocolTypeDef, # (1)
SecurityGroupArns: Sequence[str],
StorageVirtualMachineArn: str,
Subdirectory: str = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (2)
) -> CreateLocationFsxOntapResponseTypeDef: # (3)
...
# create_location_fsx_ontap method usage example with argument unpacking
kwargs: CreateLocationFsxOntapRequestRequestTypeDef = { # (1)
"Protocol": ...,
"SecurityGroupArns": ...,
"StorageVirtualMachineArn": ...,
}
parent.create_location_fsx_ontap(**kwargs)
create_location_fsx_open_zfs#
Creates a transfer location for an Amazon FSx for OpenZFS file system.
Type annotations and code completion for boto3.client("datasync").create_location_fsx_open_zfs
method.
boto3 documentation
# create_location_fsx_open_zfs method definition
def create_location_fsx_open_zfs(
self,
*,
FsxFilesystemArn: str,
Protocol: FsxProtocolTypeDef, # (1)
SecurityGroupArns: Sequence[str],
Subdirectory: str = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (2)
) -> CreateLocationFsxOpenZfsResponseTypeDef: # (3)
...
# create_location_fsx_open_zfs method usage example with argument unpacking
kwargs: CreateLocationFsxOpenZfsRequestRequestTypeDef = { # (1)
"FsxFilesystemArn": ...,
"Protocol": ...,
"SecurityGroupArns": ...,
}
parent.create_location_fsx_open_zfs(**kwargs)
create_location_fsx_windows#
Creates a transfer location for an Amazon FSx for Windows File Server file system.
Type annotations and code completion for boto3.client("datasync").create_location_fsx_windows
method.
boto3 documentation
# create_location_fsx_windows method definition
def create_location_fsx_windows(
self,
*,
FsxFilesystemArn: str,
SecurityGroupArns: Sequence[str],
User: str,
Password: str,
Subdirectory: str = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (1)
Domain: str = ...,
) -> CreateLocationFsxWindowsResponseTypeDef: # (2)
...
# create_location_fsx_windows method usage example with argument unpacking
kwargs: CreateLocationFsxWindowsRequestRequestTypeDef = { # (1)
"FsxFilesystemArn": ...,
"SecurityGroupArns": ...,
"User": ...,
"Password": ...,
}
parent.create_location_fsx_windows(**kwargs)
create_location_hdfs#
Creates a transfer location for a Hadoop Distributed File System (HDFS).
Type annotations and code completion for boto3.client("datasync").create_location_hdfs
method.
boto3 documentation
# create_location_hdfs method definition
def create_location_hdfs(
self,
*,
NameNodes: Sequence[HdfsNameNodeTypeDef], # (1)
AuthenticationType: HdfsAuthenticationTypeType, # (2)
AgentArns: Sequence[str],
Subdirectory: str = ...,
BlockSize: int = ...,
ReplicationFactor: int = ...,
KmsKeyProviderUri: str = ...,
QopConfiguration: QopConfigurationTypeDef = ..., # (3)
SimpleUser: str = ...,
KerberosPrincipal: str = ...,
KerberosKeytab: BlobTypeDef = ...,
KerberosKrb5Conf: BlobTypeDef = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (4)
) -> CreateLocationHdfsResponseTypeDef: # (5)
...
- See HdfsNameNodeTypeDef
- See HdfsAuthenticationTypeType
- See QopConfigurationTypeDef
- See TagListEntryTypeDef
- See CreateLocationHdfsResponseTypeDef
# create_location_hdfs method usage example with argument unpacking
kwargs: CreateLocationHdfsRequestRequestTypeDef = { # (1)
"NameNodes": ...,
"AuthenticationType": ...,
"AgentArns": ...,
}
parent.create_location_hdfs(**kwargs)
create_location_nfs#
Creates a transfer location for a Network File System (NFS) file server.
Type annotations and code completion for boto3.client("datasync").create_location_nfs
method.
boto3 documentation
# create_location_nfs method definition
def create_location_nfs(
self,
*,
Subdirectory: str,
ServerHostname: str,
OnPremConfig: OnPremConfigTypeDef, # (1)
MountOptions: NfsMountOptionsTypeDef = ..., # (2)
Tags: Sequence[TagListEntryTypeDef] = ..., # (3)
) -> CreateLocationNfsResponseTypeDef: # (4)
...
- See OnPremConfigTypeDef
- See NfsMountOptionsTypeDef
- See TagListEntryTypeDef
- See CreateLocationNfsResponseTypeDef
# create_location_nfs method usage example with argument unpacking
kwargs: CreateLocationNfsRequestRequestTypeDef = { # (1)
"Subdirectory": ...,
"ServerHostname": ...,
"OnPremConfig": ...,
}
parent.create_location_nfs(**kwargs)
create_location_object_storage#
Creates a transfer location for an object storage system.
Type annotations and code completion for boto3.client("datasync").create_location_object_storage
method.
boto3 documentation
# create_location_object_storage method definition
def create_location_object_storage(
self,
*,
ServerHostname: str,
BucketName: str,
AgentArns: Sequence[str],
ServerPort: int = ...,
ServerProtocol: ObjectStorageServerProtocolType = ..., # (1)
Subdirectory: str = ...,
AccessKey: str = ...,
SecretKey: str = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (2)
ServerCertificate: BlobTypeDef = ...,
) -> CreateLocationObjectStorageResponseTypeDef: # (3)
...
- See ObjectStorageServerProtocolType
- See TagListEntryTypeDef
- See CreateLocationObjectStorageResponseTypeDef
# create_location_object_storage method usage example with argument unpacking
kwargs: CreateLocationObjectStorageRequestRequestTypeDef = { # (1)
"ServerHostname": ...,
"BucketName": ...,
"AgentArns": ...,
}
parent.create_location_object_storage(**kwargs)
create_location_s3#
Creates a transfer location for an Amazon S3 bucket.
Type annotations and code completion for boto3.client("datasync").create_location_s3
method.
boto3 documentation
# create_location_s3 method definition
def create_location_s3(
self,
*,
S3BucketArn: str,
S3Config: S3ConfigTypeDef, # (1)
Subdirectory: str = ...,
S3StorageClass: S3StorageClassType = ..., # (2)
AgentArns: Sequence[str] = ...,
Tags: Sequence[TagListEntryTypeDef] = ..., # (3)
) -> CreateLocationS3ResponseTypeDef: # (4)
...
- See S3ConfigTypeDef
- See S3StorageClassType
- See TagListEntryTypeDef
- See CreateLocationS3ResponseTypeDef
# create_location_s3 method usage example with argument unpacking
kwargs: CreateLocationS3RequestRequestTypeDef = { # (1)
"S3BucketArn": ...,
"S3Config": ...,
}
parent.create_location_s3(**kwargs)
create_location_smb#
Creates a transfer location for a Server Message Block (SMB) file server.
Type annotations and code completion for boto3.client("datasync").create_location_smb
method.
boto3 documentation
# create_location_smb method definition
def create_location_smb(
self,
*,
Subdirectory: str,
ServerHostname: str,
User: str,
Password: str,
AgentArns: Sequence[str],
Domain: str = ...,
MountOptions: SmbMountOptionsTypeDef = ..., # (1)
Tags: Sequence[TagListEntryTypeDef] = ..., # (2)
) -> CreateLocationSmbResponseTypeDef: # (3)
...
# create_location_smb method usage example with argument unpacking
kwargs: CreateLocationSmbRequestRequestTypeDef = { # (1)
"Subdirectory": ...,
"ServerHostname": ...,
"User": ...,
"Password": ...,
"AgentArns": ...,
}
parent.create_location_smb(**kwargs)
create_task#
Configures a task, which defines where and how DataSync transfers your data.
Type annotations and code completion for boto3.client("datasync").create_task
method.
boto3 documentation
# create_task method definition
def create_task(
self,
*,
SourceLocationArn: str,
DestinationLocationArn: str,
CloudWatchLogGroupArn: str = ...,
Name: str = ...,
Options: OptionsTypeDef = ..., # (1)
Excludes: Sequence[FilterRuleTypeDef] = ..., # (2)
Schedule: TaskScheduleTypeDef = ..., # (3)
Tags: Sequence[TagListEntryTypeDef] = ..., # (4)
Includes: Sequence[FilterRuleTypeDef] = ..., # (2)
ManifestConfig: ManifestConfigTypeDef = ..., # (6)
TaskReportConfig: TaskReportConfigTypeDef = ..., # (7)
TaskMode: TaskModeType = ..., # (8)
) -> CreateTaskResponseTypeDef: # (9)
...
- See OptionsTypeDef
- See FilterRuleTypeDef
- See TaskScheduleTypeDef
- See TagListEntryTypeDef
- See FilterRuleTypeDef
- See ManifestConfigTypeDef
- See TaskReportConfigTypeDef
- See TaskModeType
- See CreateTaskResponseTypeDef
# create_task method usage example with argument unpacking
kwargs: CreateTaskRequestRequestTypeDef = { # (1)
"SourceLocationArn": ...,
"DestinationLocationArn": ...,
}
parent.create_task(**kwargs)
delete_agent#
Removes an DataSync agent resource from your Amazon Web Services account.
Type annotations and code completion for boto3.client("datasync").delete_agent
method.
boto3 documentation
# delete_agent method definition
def delete_agent(
self,
*,
AgentArn: str,
) -> Dict[str, Any]:
...
# delete_agent method usage example with argument unpacking
kwargs: DeleteAgentRequestRequestTypeDef = { # (1)
"AgentArn": ...,
}
parent.delete_agent(**kwargs)
delete_location#
Deletes a transfer location resource from DataSync.
Type annotations and code completion for boto3.client("datasync").delete_location
method.
boto3 documentation
# delete_location method definition
def delete_location(
self,
*,
LocationArn: str,
) -> Dict[str, Any]:
...
# delete_location method usage example with argument unpacking
kwargs: DeleteLocationRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.delete_location(**kwargs)
delete_task#
Deletes a transfer task resource from DataSync.
Type annotations and code completion for boto3.client("datasync").delete_task
method.
boto3 documentation
# delete_task method definition
def delete_task(
self,
*,
TaskArn: str,
) -> Dict[str, Any]:
...
# delete_task method usage example with argument unpacking
kwargs: DeleteTaskRequestRequestTypeDef = { # (1)
"TaskArn": ...,
}
parent.delete_task(**kwargs)
describe_agent#
Returns information about an DataSync agent, such as its name, service endpoint type, and status.
Type annotations and code completion for boto3.client("datasync").describe_agent
method.
boto3 documentation
# describe_agent method definition
def describe_agent(
self,
*,
AgentArn: str,
) -> DescribeAgentResponseTypeDef: # (1)
...
# describe_agent method usage example with argument unpacking
kwargs: DescribeAgentRequestRequestTypeDef = { # (1)
"AgentArn": ...,
}
parent.describe_agent(**kwargs)
describe_discovery_job#
Returns information about a DataSync discovery job.
Type annotations and code completion for boto3.client("datasync").describe_discovery_job
method.
boto3 documentation
# describe_discovery_job method definition
def describe_discovery_job(
self,
*,
DiscoveryJobArn: str,
) -> DescribeDiscoveryJobResponseTypeDef: # (1)
...
# describe_discovery_job method usage example with argument unpacking
kwargs: DescribeDiscoveryJobRequestRequestTypeDef = { # (1)
"DiscoveryJobArn": ...,
}
parent.describe_discovery_job(**kwargs)
describe_location_azure_blob#
Provides details about how an DataSync transfer location for Microsoft Azure Blob Storage is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_azure_blob
method.
boto3 documentation
# describe_location_azure_blob method definition
def describe_location_azure_blob(
self,
*,
LocationArn: str,
) -> DescribeLocationAzureBlobResponseTypeDef: # (1)
...
# describe_location_azure_blob method usage example with argument unpacking
kwargs: DescribeLocationAzureBlobRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_azure_blob(**kwargs)
describe_location_efs#
Provides details about how an DataSync transfer location for an Amazon EFS file system is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_efs
method.
boto3 documentation
# describe_location_efs method definition
def describe_location_efs(
self,
*,
LocationArn: str,
) -> DescribeLocationEfsResponseTypeDef: # (1)
...
# describe_location_efs method usage example with argument unpacking
kwargs: DescribeLocationEfsRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_efs(**kwargs)
describe_location_fsx_lustre#
Provides details about how an DataSync transfer location for an Amazon FSx for Lustre file system is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_fsx_lustre
method.
boto3 documentation
# describe_location_fsx_lustre method definition
def describe_location_fsx_lustre(
self,
*,
LocationArn: str,
) -> DescribeLocationFsxLustreResponseTypeDef: # (1)
...
# describe_location_fsx_lustre method usage example with argument unpacking
kwargs: DescribeLocationFsxLustreRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_fsx_lustre(**kwargs)
describe_location_fsx_ontap#
Provides details about how an DataSync transfer location for an Amazon FSx for NetApp ONTAP file system is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_fsx_ontap
method.
boto3 documentation
# describe_location_fsx_ontap method definition
def describe_location_fsx_ontap(
self,
*,
LocationArn: str,
) -> DescribeLocationFsxOntapResponseTypeDef: # (1)
...
# describe_location_fsx_ontap method usage example with argument unpacking
kwargs: DescribeLocationFsxOntapRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_fsx_ontap(**kwargs)
describe_location_fsx_open_zfs#
Provides details about how an DataSync transfer location for an Amazon FSx for OpenZFS file system is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_fsx_open_zfs
method.
boto3 documentation
# describe_location_fsx_open_zfs method definition
def describe_location_fsx_open_zfs(
self,
*,
LocationArn: str,
) -> DescribeLocationFsxOpenZfsResponseTypeDef: # (1)
...
# describe_location_fsx_open_zfs method usage example with argument unpacking
kwargs: DescribeLocationFsxOpenZfsRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_fsx_open_zfs(**kwargs)
describe_location_fsx_windows#
Provides details about how an DataSync transfer location for an Amazon FSx for Windows File Server file system is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_fsx_windows
method.
boto3 documentation
# describe_location_fsx_windows method definition
def describe_location_fsx_windows(
self,
*,
LocationArn: str,
) -> DescribeLocationFsxWindowsResponseTypeDef: # (1)
...
# describe_location_fsx_windows method usage example with argument unpacking
kwargs: DescribeLocationFsxWindowsRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_fsx_windows(**kwargs)
describe_location_hdfs#
Provides details about how an DataSync transfer location for a Hadoop Distributed File System (HDFS) is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_hdfs
method.
boto3 documentation
# describe_location_hdfs method definition
def describe_location_hdfs(
self,
*,
LocationArn: str,
) -> DescribeLocationHdfsResponseTypeDef: # (1)
...
# describe_location_hdfs method usage example with argument unpacking
kwargs: DescribeLocationHdfsRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_hdfs(**kwargs)
describe_location_nfs#
Provides details about how an DataSync transfer location for a Network File System (NFS) file server is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_nfs
method.
boto3 documentation
# describe_location_nfs method definition
def describe_location_nfs(
self,
*,
LocationArn: str,
) -> DescribeLocationNfsResponseTypeDef: # (1)
...
# describe_location_nfs method usage example with argument unpacking
kwargs: DescribeLocationNfsRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_nfs(**kwargs)
describe_location_object_storage#
Provides details about how an DataSync transfer location for an object storage system is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_object_storage
method.
boto3 documentation
# describe_location_object_storage method definition
def describe_location_object_storage(
self,
*,
LocationArn: str,
) -> DescribeLocationObjectStorageResponseTypeDef: # (1)
...
# describe_location_object_storage method usage example with argument unpacking
kwargs: DescribeLocationObjectStorageRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_object_storage(**kwargs)
describe_location_s3#
Provides details about how an DataSync transfer location for an S3 bucket is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_s3
method.
boto3 documentation
# describe_location_s3 method definition
def describe_location_s3(
self,
*,
LocationArn: str,
) -> DescribeLocationS3ResponseTypeDef: # (1)
...
# describe_location_s3 method usage example with argument unpacking
kwargs: DescribeLocationS3RequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_s3(**kwargs)
describe_location_smb#
Provides details about how an DataSync transfer location for a Server Message Block (SMB) file server is configured.
Type annotations and code completion for boto3.client("datasync").describe_location_smb
method.
boto3 documentation
# describe_location_smb method definition
def describe_location_smb(
self,
*,
LocationArn: str,
) -> DescribeLocationSmbResponseTypeDef: # (1)
...
# describe_location_smb method usage example with argument unpacking
kwargs: DescribeLocationSmbRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.describe_location_smb(**kwargs)
describe_storage_system#
Returns information about an on-premises storage system that you're using with DataSync Discovery.
Type annotations and code completion for boto3.client("datasync").describe_storage_system
method.
boto3 documentation
# describe_storage_system method definition
def describe_storage_system(
self,
*,
StorageSystemArn: str,
) -> DescribeStorageSystemResponseTypeDef: # (1)
...
# describe_storage_system method usage example with argument unpacking
kwargs: DescribeStorageSystemRequestRequestTypeDef = { # (1)
"StorageSystemArn": ...,
}
parent.describe_storage_system(**kwargs)
describe_storage_system_resource_metrics#
Returns information, including performance data and capacity usage, which DataSync Discovery collects about a specific resource in your-premises storage system.
Type annotations and code completion for boto3.client("datasync").describe_storage_system_resource_metrics
method.
boto3 documentation
# describe_storage_system_resource_metrics method definition
def describe_storage_system_resource_metrics(
self,
*,
DiscoveryJobArn: str,
ResourceType: DiscoveryResourceTypeType, # (1)
ResourceId: str,
StartTime: TimestampTypeDef = ...,
EndTime: TimestampTypeDef = ...,
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeStorageSystemResourceMetricsResponseTypeDef: # (2)
...
# describe_storage_system_resource_metrics method usage example with argument unpacking
kwargs: DescribeStorageSystemResourceMetricsRequestRequestTypeDef = { # (1)
"DiscoveryJobArn": ...,
"ResourceType": ...,
"ResourceId": ...,
}
parent.describe_storage_system_resource_metrics(**kwargs)
describe_storage_system_resources#
Returns information that DataSync Discovery collects about resources in your on-premises storage system.
Type annotations and code completion for boto3.client("datasync").describe_storage_system_resources
method.
boto3 documentation
# describe_storage_system_resources method definition
def describe_storage_system_resources(
self,
*,
DiscoveryJobArn: str,
ResourceType: DiscoveryResourceTypeType, # (1)
ResourceIds: Sequence[str] = ...,
Filter: Mapping[DiscoveryResourceFilterType, Sequence[str]] = ..., # (2)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeStorageSystemResourcesResponseTypeDef: # (3)
...
- See DiscoveryResourceTypeType
- See DiscoveryResourceFilterType
- See DescribeStorageSystemResourcesResponseTypeDef
# describe_storage_system_resources method usage example with argument unpacking
kwargs: DescribeStorageSystemResourcesRequestRequestTypeDef = { # (1)
"DiscoveryJobArn": ...,
"ResourceType": ...,
}
parent.describe_storage_system_resources(**kwargs)
describe_task#
Provides information about a task, which defines where and how DataSync transfers your data.
Type annotations and code completion for boto3.client("datasync").describe_task
method.
boto3 documentation
# describe_task method definition
def describe_task(
self,
*,
TaskArn: str,
) -> DescribeTaskResponseTypeDef: # (1)
...
# describe_task method usage example with argument unpacking
kwargs: DescribeTaskRequestRequestTypeDef = { # (1)
"TaskArn": ...,
}
parent.describe_task(**kwargs)
describe_task_execution#
Provides information about an execution of your DataSync task.
Type annotations and code completion for boto3.client("datasync").describe_task_execution
method.
boto3 documentation
# describe_task_execution method definition
def describe_task_execution(
self,
*,
TaskExecutionArn: str,
) -> DescribeTaskExecutionResponseTypeDef: # (1)
...
# describe_task_execution method usage example with argument unpacking
kwargs: DescribeTaskExecutionRequestRequestTypeDef = { # (1)
"TaskExecutionArn": ...,
}
parent.describe_task_execution(**kwargs)
generate_presigned_url#
Generate a presigned url given a client, its method, and arguments.
Type annotations and code completion for boto3.client("datasync").generate_presigned_url
method.
boto3 documentation
# generate_presigned_url method definition
def generate_presigned_url(
self,
ClientMethod: str,
Params: Mapping[str, Any] = ...,
ExpiresIn: int = 3600,
HttpMethod: str = ...,
) -> str:
...
generate_recommendations#
Creates recommendations about where to migrate your data to in Amazon Web Services.
Type annotations and code completion for boto3.client("datasync").generate_recommendations
method.
boto3 documentation
# generate_recommendations method definition
def generate_recommendations(
self,
*,
DiscoveryJobArn: str,
ResourceIds: Sequence[str],
ResourceType: DiscoveryResourceTypeType, # (1)
) -> Dict[str, Any]:
...
# generate_recommendations method usage example with argument unpacking
kwargs: GenerateRecommendationsRequestRequestTypeDef = { # (1)
"DiscoveryJobArn": ...,
"ResourceIds": ...,
"ResourceType": ...,
}
parent.generate_recommendations(**kwargs)
list_agents#
Returns a list of DataSync agents that belong to an Amazon Web Services account in the Amazon Web Services Region specified in the request.
Type annotations and code completion for boto3.client("datasync").list_agents
method.
boto3 documentation
# list_agents method definition
def list_agents(
self,
*,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListAgentsResponseTypeDef: # (1)
...
# list_agents method usage example with argument unpacking
kwargs: ListAgentsRequestRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.list_agents(**kwargs)
list_discovery_jobs#
Provides a list of the existing discovery jobs in the Amazon Web Services Region and Amazon Web Services account where you're using DataSync Discovery.
Type annotations and code completion for boto3.client("datasync").list_discovery_jobs
method.
boto3 documentation
# list_discovery_jobs method definition
def list_discovery_jobs(
self,
*,
StorageSystemArn: str = ...,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListDiscoveryJobsResponseTypeDef: # (1)
...
# list_discovery_jobs method usage example with argument unpacking
kwargs: ListDiscoveryJobsRequestRequestTypeDef = { # (1)
"StorageSystemArn": ...,
}
parent.list_discovery_jobs(**kwargs)
list_locations#
Returns a list of source and destination locations.
Type annotations and code completion for boto3.client("datasync").list_locations
method.
boto3 documentation
# list_locations method definition
def list_locations(
self,
*,
MaxResults: int = ...,
NextToken: str = ...,
Filters: Sequence[LocationFilterTypeDef] = ..., # (1)
) -> ListLocationsResponseTypeDef: # (2)
...
# list_locations method usage example with argument unpacking
kwargs: ListLocationsRequestRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.list_locations(**kwargs)
list_storage_systems#
Lists the on-premises storage systems that you're using with DataSync Discovery.
Type annotations and code completion for boto3.client("datasync").list_storage_systems
method.
boto3 documentation
# list_storage_systems method definition
def list_storage_systems(
self,
*,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListStorageSystemsResponseTypeDef: # (1)
...
# list_storage_systems method usage example with argument unpacking
kwargs: ListStorageSystemsRequestRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.list_storage_systems(**kwargs)
list_tags_for_resource#
Returns all the tags associated with an Amazon Web Services resource.
Type annotations and code completion for boto3.client("datasync").list_tags_for_resource
method.
boto3 documentation
# list_tags_for_resource method definition
def list_tags_for_resource(
self,
*,
ResourceArn: str,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListTagsForResourceResponseTypeDef: # (1)
...
# list_tags_for_resource method usage example with argument unpacking
kwargs: ListTagsForResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
}
parent.list_tags_for_resource(**kwargs)
list_task_executions#
Returns a list of executions for an DataSync transfer task.
Type annotations and code completion for boto3.client("datasync").list_task_executions
method.
boto3 documentation
# list_task_executions method definition
def list_task_executions(
self,
*,
TaskArn: str = ...,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListTaskExecutionsResponseTypeDef: # (1)
...
# list_task_executions method usage example with argument unpacking
kwargs: ListTaskExecutionsRequestRequestTypeDef = { # (1)
"TaskArn": ...,
}
parent.list_task_executions(**kwargs)
list_tasks#
Returns a list of the DataSync tasks you created.
Type annotations and code completion for boto3.client("datasync").list_tasks
method.
boto3 documentation
# list_tasks method definition
def list_tasks(
self,
*,
MaxResults: int = ...,
NextToken: str = ...,
Filters: Sequence[TaskFilterTypeDef] = ..., # (1)
) -> ListTasksResponseTypeDef: # (2)
...
# list_tasks method usage example with argument unpacking
kwargs: ListTasksRequestRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.list_tasks(**kwargs)
remove_storage_system#
Permanently removes a storage system resource from DataSync Discovery, including the associated discovery jobs, collected data, and recommendations.
Type annotations and code completion for boto3.client("datasync").remove_storage_system
method.
boto3 documentation
# remove_storage_system method definition
def remove_storage_system(
self,
*,
StorageSystemArn: str,
) -> Dict[str, Any]:
...
# remove_storage_system method usage example with argument unpacking
kwargs: RemoveStorageSystemRequestRequestTypeDef = { # (1)
"StorageSystemArn": ...,
}
parent.remove_storage_system(**kwargs)
start_discovery_job#
Runs a DataSync discovery job on your on-premises storage system.
Type annotations and code completion for boto3.client("datasync").start_discovery_job
method.
boto3 documentation
# start_discovery_job method definition
def start_discovery_job(
self,
*,
StorageSystemArn: str,
CollectionDurationMinutes: int,
ClientToken: str,
Tags: Sequence[TagListEntryTypeDef] = ..., # (1)
) -> StartDiscoveryJobResponseTypeDef: # (2)
...
# start_discovery_job method usage example with argument unpacking
kwargs: StartDiscoveryJobRequestRequestTypeDef = { # (1)
"StorageSystemArn": ...,
"CollectionDurationMinutes": ...,
"ClientToken": ...,
}
parent.start_discovery_job(**kwargs)
start_task_execution#
Starts an DataSync transfer task.
Type annotations and code completion for boto3.client("datasync").start_task_execution
method.
boto3 documentation
# start_task_execution method definition
def start_task_execution(
self,
*,
TaskArn: str,
OverrideOptions: OptionsTypeDef = ..., # (1)
Includes: Sequence[FilterRuleTypeDef] = ..., # (2)
Excludes: Sequence[FilterRuleTypeDef] = ..., # (2)
ManifestConfig: ManifestConfigTypeDef = ..., # (4)
TaskReportConfig: TaskReportConfigTypeDef = ..., # (5)
Tags: Sequence[TagListEntryTypeDef] = ..., # (6)
) -> StartTaskExecutionResponseTypeDef: # (7)
...
- See OptionsTypeDef
- See FilterRuleTypeDef
- See FilterRuleTypeDef
- See ManifestConfigTypeDef
- See TaskReportConfigTypeDef
- See TagListEntryTypeDef
- See StartTaskExecutionResponseTypeDef
# start_task_execution method usage example with argument unpacking
kwargs: StartTaskExecutionRequestRequestTypeDef = { # (1)
"TaskArn": ...,
}
parent.start_task_execution(**kwargs)
stop_discovery_job#
Stops a running DataSync discovery job.
Type annotations and code completion for boto3.client("datasync").stop_discovery_job
method.
boto3 documentation
# stop_discovery_job method definition
def stop_discovery_job(
self,
*,
DiscoveryJobArn: str,
) -> Dict[str, Any]:
...
# stop_discovery_job method usage example with argument unpacking
kwargs: StopDiscoveryJobRequestRequestTypeDef = { # (1)
"DiscoveryJobArn": ...,
}
parent.stop_discovery_job(**kwargs)
tag_resource#
Applies a tag to an Amazon Web Services resource.
Type annotations and code completion for boto3.client("datasync").tag_resource
method.
boto3 documentation
# tag_resource method definition
def tag_resource(
self,
*,
ResourceArn: str,
Tags: Sequence[TagListEntryTypeDef], # (1)
) -> Dict[str, Any]:
...
# tag_resource method usage example with argument unpacking
kwargs: TagResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
"Tags": ...,
}
parent.tag_resource(**kwargs)
untag_resource#
Removes tags from an Amazon Web Services resource.
Type annotations and code completion for boto3.client("datasync").untag_resource
method.
boto3 documentation
# untag_resource method definition
def untag_resource(
self,
*,
ResourceArn: str,
Keys: Sequence[str],
) -> Dict[str, Any]:
...
# untag_resource method usage example with argument unpacking
kwargs: UntagResourceRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
"Keys": ...,
}
parent.untag_resource(**kwargs)
update_agent#
Updates the name of an DataSync agent.
Type annotations and code completion for boto3.client("datasync").update_agent
method.
boto3 documentation
# update_agent method definition
def update_agent(
self,
*,
AgentArn: str,
Name: str = ...,
) -> Dict[str, Any]:
...
# update_agent method usage example with argument unpacking
kwargs: UpdateAgentRequestRequestTypeDef = { # (1)
"AgentArn": ...,
}
parent.update_agent(**kwargs)
update_discovery_job#
Edits a DataSync discovery job configuration.
Type annotations and code completion for boto3.client("datasync").update_discovery_job
method.
boto3 documentation
# update_discovery_job method definition
def update_discovery_job(
self,
*,
DiscoveryJobArn: str,
CollectionDurationMinutes: int,
) -> Dict[str, Any]:
...
# update_discovery_job method usage example with argument unpacking
kwargs: UpdateDiscoveryJobRequestRequestTypeDef = { # (1)
"DiscoveryJobArn": ...,
"CollectionDurationMinutes": ...,
}
parent.update_discovery_job(**kwargs)
update_location_azure_blob#
Modifies some configurations of the Microsoft Azure Blob Storage transfer location that you're using with DataSync.
Type annotations and code completion for boto3.client("datasync").update_location_azure_blob
method.
boto3 documentation
# update_location_azure_blob method definition
def update_location_azure_blob(
self,
*,
LocationArn: str,
Subdirectory: str = ...,
AuthenticationType: AzureBlobAuthenticationTypeType = ..., # (1)
SasConfiguration: AzureBlobSasConfigurationTypeDef = ..., # (2)
BlobType: AzureBlobTypeType = ..., # (3)
AccessTier: AzureAccessTierType = ..., # (4)
AgentArns: Sequence[str] = ...,
) -> Dict[str, Any]:
...
- See AzureBlobAuthenticationTypeType
- See AzureBlobSasConfigurationTypeDef
- See AzureBlobTypeType
- See AzureAccessTierType
# update_location_azure_blob method usage example with argument unpacking
kwargs: UpdateLocationAzureBlobRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.update_location_azure_blob(**kwargs)
update_location_hdfs#
Updates some parameters of a previously created location for a Hadoop Distributed File System cluster.
Type annotations and code completion for boto3.client("datasync").update_location_hdfs
method.
boto3 documentation
# update_location_hdfs method definition
def update_location_hdfs(
self,
*,
LocationArn: str,
Subdirectory: str = ...,
NameNodes: Sequence[HdfsNameNodeTypeDef] = ..., # (1)
BlockSize: int = ...,
ReplicationFactor: int = ...,
KmsKeyProviderUri: str = ...,
QopConfiguration: QopConfigurationTypeDef = ..., # (2)
AuthenticationType: HdfsAuthenticationTypeType = ..., # (3)
SimpleUser: str = ...,
KerberosPrincipal: str = ...,
KerberosKeytab: BlobTypeDef = ...,
KerberosKrb5Conf: BlobTypeDef = ...,
AgentArns: Sequence[str] = ...,
) -> Dict[str, Any]:
...
# update_location_hdfs method usage example with argument unpacking
kwargs: UpdateLocationHdfsRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.update_location_hdfs(**kwargs)
update_location_nfs#
Modifies some configurations of the Network File System (NFS) transfer location that you're using with DataSync.
Type annotations and code completion for boto3.client("datasync").update_location_nfs
method.
boto3 documentation
# update_location_nfs method definition
def update_location_nfs(
self,
*,
LocationArn: str,
Subdirectory: str = ...,
OnPremConfig: OnPremConfigTypeDef = ..., # (1)
MountOptions: NfsMountOptionsTypeDef = ..., # (2)
) -> Dict[str, Any]:
...
# update_location_nfs method usage example with argument unpacking
kwargs: UpdateLocationNfsRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.update_location_nfs(**kwargs)
update_location_object_storage#
Updates some parameters of an existing DataSync location for an object storage system.
Type annotations and code completion for boto3.client("datasync").update_location_object_storage
method.
boto3 documentation
# update_location_object_storage method definition
def update_location_object_storage(
self,
*,
LocationArn: str,
ServerPort: int = ...,
ServerProtocol: ObjectStorageServerProtocolType = ..., # (1)
Subdirectory: str = ...,
AccessKey: str = ...,
SecretKey: str = ...,
AgentArns: Sequence[str] = ...,
ServerCertificate: BlobTypeDef = ...,
) -> Dict[str, Any]:
...
# update_location_object_storage method usage example with argument unpacking
kwargs: UpdateLocationObjectStorageRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.update_location_object_storage(**kwargs)
update_location_smb#
Updates some of the parameters of a Server Message Block (SMB) file server location that you can use for DataSync transfers.
Type annotations and code completion for boto3.client("datasync").update_location_smb
method.
boto3 documentation
# update_location_smb method definition
def update_location_smb(
self,
*,
LocationArn: str,
Subdirectory: str = ...,
User: str = ...,
Domain: str = ...,
Password: str = ...,
AgentArns: Sequence[str] = ...,
MountOptions: SmbMountOptionsTypeDef = ..., # (1)
) -> Dict[str, Any]:
...
# update_location_smb method usage example with argument unpacking
kwargs: UpdateLocationSmbRequestRequestTypeDef = { # (1)
"LocationArn": ...,
}
parent.update_location_smb(**kwargs)
update_storage_system#
Modifies some configurations of an on-premises storage system resource that you're using with DataSync Discovery.
Type annotations and code completion for boto3.client("datasync").update_storage_system
method.
boto3 documentation
# update_storage_system method definition
def update_storage_system(
self,
*,
StorageSystemArn: str,
ServerConfiguration: DiscoveryServerConfigurationTypeDef = ..., # (1)
AgentArns: Sequence[str] = ...,
Name: str = ...,
CloudWatchLogGroupArn: str = ...,
Credentials: CredentialsTypeDef = ..., # (2)
) -> Dict[str, Any]:
...
# update_storage_system method usage example with argument unpacking
kwargs: UpdateStorageSystemRequestRequestTypeDef = { # (1)
"StorageSystemArn": ...,
}
parent.update_storage_system(**kwargs)
update_task#
Updates the configuration of a task, which defines where and how DataSync transfers your data.
Type annotations and code completion for boto3.client("datasync").update_task
method.
boto3 documentation
# update_task method definition
def update_task(
self,
*,
TaskArn: str,
Options: OptionsTypeDef = ..., # (1)
Excludes: Sequence[FilterRuleTypeDef] = ..., # (2)
Schedule: TaskScheduleTypeDef = ..., # (3)
Name: str = ...,
CloudWatchLogGroupArn: str = ...,
Includes: Sequence[FilterRuleTypeDef] = ..., # (2)
ManifestConfig: ManifestConfigTypeDef = ..., # (5)
TaskReportConfig: TaskReportConfigTypeDef = ..., # (6)
) -> Dict[str, Any]:
...
- See OptionsTypeDef
- See FilterRuleTypeDef
- See TaskScheduleTypeDef
- See FilterRuleTypeDef
- See ManifestConfigTypeDef
- See TaskReportConfigTypeDef
# update_task method usage example with argument unpacking
kwargs: UpdateTaskRequestRequestTypeDef = { # (1)
"TaskArn": ...,
}
parent.update_task(**kwargs)
update_task_execution#
Updates the configuration of a running DataSync task execution.
Type annotations and code completion for boto3.client("datasync").update_task_execution
method.
boto3 documentation
# update_task_execution method definition
def update_task_execution(
self,
*,
TaskExecutionArn: str,
Options: OptionsTypeDef, # (1)
) -> Dict[str, Any]:
...
- See OptionsTypeDef
# update_task_execution method usage example with argument unpacking
kwargs: UpdateTaskExecutionRequestRequestTypeDef = { # (1)
"TaskExecutionArn": ...,
"Options": ...,
}
parent.update_task_execution(**kwargs)
get_paginator#
Type annotations and code completion for boto3.client("datasync").get_paginator
method with overloads.
client.get_paginator("describe_storage_system_resource_metrics")
-> DescribeStorageSystemResourceMetricsPaginatorclient.get_paginator("list_agents")
-> ListAgentsPaginatorclient.get_paginator("list_discovery_jobs")
-> ListDiscoveryJobsPaginatorclient.get_paginator("list_locations")
-> ListLocationsPaginatorclient.get_paginator("list_storage_systems")
-> ListStorageSystemsPaginatorclient.get_paginator("list_tags_for_resource")
-> ListTagsForResourcePaginatorclient.get_paginator("list_task_executions")
-> ListTaskExecutionsPaginatorclient.get_paginator("list_tasks")
-> ListTasksPaginator