1 | import {Request} from '../lib/request';
|
2 | import {Response} from '../lib/response';
|
3 | import {AWSError} from '../lib/error';
|
4 | import {Service} from '../lib/service';
|
5 | import {ServiceConfigurationOptions} from '../lib/service';
|
6 | import {ConfigBase as Config} from '../lib/config';
|
7 | import {UseDualstackConfigOptions} from '../lib/config_use_dualstack';
|
8 | interface Blob {}
|
9 | declare class S3Control extends Service {
|
10 | |
11 |
|
12 |
|
13 | constructor(options?: S3Control.Types.ClientConfiguration)
|
14 | config: Config & S3Control.Types.ClientConfiguration;
|
15 | /**
|
16 | * Creates an Amazon S3 batch operations job.
|
17 | */
|
18 | createJob(params: S3Control.Types.CreateJobRequest, callback?: (err: AWSError, data: S3Control.Types.CreateJobResult) => void): Request<S3Control.Types.CreateJobResult, AWSError>;
|
19 | /**
|
20 | * Creates an Amazon S3 batch operations job.
|
21 | */
|
22 | createJob(callback?: (err: AWSError, data: S3Control.Types.CreateJobResult) => void): Request<S3Control.Types.CreateJobResult, AWSError>;
|
23 | /**
|
24 | * Deletes the block public access configuration for the specified account.
|
25 | */
|
26 | deletePublicAccessBlock(params: S3Control.Types.DeletePublicAccessBlockRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
|
27 | |
28 |
|
29 |
|
30 | deletePublicAccessBlock(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
|
31 | |
32 |
|
33 |
|
34 | describeJob(params: S3Control.Types.DescribeJobRequest, callback?: (err: AWSError, data: S3Control.Types.DescribeJobResult) => void): Request<S3Control.Types.DescribeJobResult, AWSError>;
|
35 | |
36 |
|
37 |
|
38 | describeJob(callback?: (err: AWSError, data: S3Control.Types.DescribeJobResult) => void): Request<S3Control.Types.DescribeJobResult, AWSError>;
|
39 | |
40 |
|
41 |
|
42 | getPublicAccessBlock(params: S3Control.Types.GetPublicAccessBlockRequest, callback?: (err: AWSError, data: S3Control.Types.GetPublicAccessBlockOutput) => void): Request<S3Control.Types.GetPublicAccessBlockOutput, AWSError>;
|
43 | |
44 |
|
45 |
|
46 | getPublicAccessBlock(callback?: (err: AWSError, data: S3Control.Types.GetPublicAccessBlockOutput) => void): Request<S3Control.Types.GetPublicAccessBlockOutput, AWSError>;
|
47 | |
48 |
|
49 |
|
50 | listJobs(params: S3Control.Types.ListJobsRequest, callback?: (err: AWSError, data: S3Control.Types.ListJobsResult) => void): Request<S3Control.Types.ListJobsResult, AWSError>;
|
51 | |
52 |
|
53 |
|
54 | listJobs(callback?: (err: AWSError, data: S3Control.Types.ListJobsResult) => void): Request<S3Control.Types.ListJobsResult, AWSError>;
|
55 | |
56 |
|
57 |
|
58 | putPublicAccessBlock(params: S3Control.Types.PutPublicAccessBlockRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
|
59 | |
60 |
|
61 |
|
62 | putPublicAccessBlock(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
|
63 | |
64 |
|
65 |
|
66 | updateJobPriority(params: S3Control.Types.UpdateJobPriorityRequest, callback?: (err: AWSError, data: S3Control.Types.UpdateJobPriorityResult) => void): Request<S3Control.Types.UpdateJobPriorityResult, AWSError>;
|
67 | |
68 |
|
69 |
|
70 | updateJobPriority(callback?: (err: AWSError, data: S3Control.Types.UpdateJobPriorityResult) => void): Request<S3Control.Types.UpdateJobPriorityResult, AWSError>;
|
71 | |
72 |
|
73 |
|
74 | updateJobStatus(params: S3Control.Types.UpdateJobStatusRequest, callback?: (err: AWSError, data: S3Control.Types.UpdateJobStatusResult) => void): Request<S3Control.Types.UpdateJobStatusResult, AWSError>;
|
75 | |
76 |
|
77 |
|
78 | updateJobStatus(callback?: (err: AWSError, data: S3Control.Types.UpdateJobStatusResult) => void): Request<S3Control.Types.UpdateJobStatusResult, AWSError>;
|
79 | }
|
80 | declare namespace S3Control {
|
81 | export type AccountId = string;
|
82 | export type Boolean = boolean;
|
83 | export type ConfirmationRequired = boolean;
|
84 | export interface CreateJobRequest {
|
85 | |
86 |
|
87 |
|
88 | AccountId: AccountId;
|
89 | |
90 |
|
91 |
|
92 | ConfirmationRequired?: ConfirmationRequired;
|
93 | |
94 |
|
95 |
|
96 | Operation: JobOperation;
|
97 | |
98 |
|
99 |
|
100 | Report: JobReport;
|
101 | |
102 |
|
103 |
|
104 | ClientRequestToken: NonEmptyMaxLength64String;
|
105 | |
106 |
|
107 |
|
108 | Manifest: JobManifest;
|
109 | |
110 |
|
111 |
|
112 | Description?: NonEmptyMaxLength256String;
|
113 | |
114 |
|
115 |
|
116 | Priority: JobPriority;
|
117 | |
118 |
|
119 |
|
120 | RoleArn: IAMRoleArn;
|
121 | }
|
122 | export interface CreateJobResult {
|
123 | |
124 |
|
125 |
|
126 | JobId?: JobId;
|
127 | }
|
128 | export interface DeletePublicAccessBlockRequest {
|
129 | |
130 |
|
131 |
|
132 | AccountId: AccountId;
|
133 | }
|
134 | export interface DescribeJobRequest {
|
135 | |
136 |
|
137 |
|
138 | AccountId: AccountId;
|
139 | |
140 |
|
141 |
|
142 | JobId: JobId;
|
143 | }
|
144 | export interface DescribeJobResult {
|
145 | |
146 |
|
147 |
|
148 | Job?: JobDescriptor;
|
149 | }
|
150 | export interface GetPublicAccessBlockOutput {
|
151 | |
152 |
|
153 |
|
154 | PublicAccessBlockConfiguration?: PublicAccessBlockConfiguration;
|
155 | }
|
156 | export interface GetPublicAccessBlockRequest {
|
157 | |
158 |
|
159 |
|
160 | AccountId: AccountId;
|
161 | }
|
162 | export type IAMRoleArn = string;
|
163 | export type JobArn = string;
|
164 | export type JobCreationTime = Date;
|
165 | export interface JobDescriptor {
|
166 | |
167 |
|
168 |
|
169 | JobId?: JobId;
|
170 | |
171 |
|
172 |
|
173 | ConfirmationRequired?: ConfirmationRequired;
|
174 | |
175 |
|
176 |
|
177 | Description?: NonEmptyMaxLength256String;
|
178 | |
179 |
|
180 |
|
181 | JobArn?: JobArn;
|
182 | |
183 |
|
184 |
|
185 | Status?: JobStatus;
|
186 | |
187 |
|
188 |
|
189 | Manifest?: JobManifest;
|
190 | |
191 |
|
192 |
|
193 | Operation?: JobOperation;
|
194 | |
195 |
|
196 |
|
197 | Priority?: JobPriority;
|
198 | |
199 |
|
200 |
|
201 | ProgressSummary?: JobProgressSummary;
|
202 | |
203 |
|
204 |
|
205 | StatusUpdateReason?: JobStatusUpdateReason;
|
206 | |
207 |
|
208 |
|
209 | FailureReasons?: JobFailureList;
|
210 | |
211 |
|
212 |
|
213 | Report?: JobReport;
|
214 | |
215 |
|
216 |
|
217 | CreationTime?: JobCreationTime;
|
218 | |
219 |
|
220 |
|
221 | TerminationDate?: JobTerminationDate;
|
222 | |
223 |
|
224 |
|
225 | RoleArn?: IAMRoleArn;
|
226 | |
227 |
|
228 |
|
229 | SuspendedDate?: SuspendedDate;
|
230 | |
231 |
|
232 |
|
233 | SuspendedCause?: SuspendedCause;
|
234 | }
|
235 | export interface JobFailure {
|
236 | |
237 |
|
238 |
|
239 | FailureCode?: JobFailureCode;
|
240 | |
241 |
|
242 |
|
243 | FailureReason?: JobFailureReason;
|
244 | }
|
245 | export type JobFailureCode = string;
|
246 | export type JobFailureList = JobFailure[];
|
247 | export type JobFailureReason = string;
|
248 | export type JobId = string;
|
249 | export interface JobListDescriptor {
|
250 | |
251 |
|
252 |
|
253 | JobId?: JobId;
|
254 | |
255 |
|
256 |
|
257 | Description?: NonEmptyMaxLength256String;
|
258 | |
259 |
|
260 |
|
261 | Operation?: OperationName;
|
262 | |
263 |
|
264 |
|
265 | Priority?: JobPriority;
|
266 | |
267 |
|
268 |
|
269 | Status?: JobStatus;
|
270 | |
271 |
|
272 |
|
273 | CreationTime?: JobCreationTime;
|
274 | |
275 |
|
276 |
|
277 | TerminationDate?: JobTerminationDate;
|
278 | |
279 |
|
280 |
|
281 | ProgressSummary?: JobProgressSummary;
|
282 | }
|
283 | export type JobListDescriptorList = JobListDescriptor[];
|
284 | export interface JobManifest {
|
285 | |
286 |
|
287 |
|
288 | Spec: JobManifestSpec;
|
289 | |
290 |
|
291 |
|
292 | Location: JobManifestLocation;
|
293 | }
|
294 | export type JobManifestFieldList = JobManifestFieldName[];
|
295 | export type JobManifestFieldName = "Ignore"|"Bucket"|"Key"|"VersionId"|string;
|
296 | export type JobManifestFormat = "S3BatchOperations_CSV_20180820"|"S3InventoryReport_CSV_20161130"|string;
|
297 | export interface JobManifestLocation {
|
298 | |
299 |
|
300 |
|
301 | ObjectArn: S3KeyArnString;
|
302 | |
303 |
|
304 |
|
305 | ObjectVersionId?: S3ObjectVersionId;
|
306 | |
307 |
|
308 |
|
309 | ETag: NonEmptyMaxLength1024String;
|
310 | }
|
311 | export interface JobManifestSpec {
|
312 | |
313 |
|
314 |
|
315 | Format: JobManifestFormat;
|
316 | |
317 |
|
318 |
|
319 | Fields?: JobManifestFieldList;
|
320 | }
|
321 | export type JobNumberOfTasksFailed = number;
|
322 | export type JobNumberOfTasksSucceeded = number;
|
323 | export interface JobOperation {
|
324 | |
325 |
|
326 |
|
327 | LambdaInvoke?: LambdaInvokeOperation;
|
328 | |
329 |
|
330 |
|
331 | S3PutObjectCopy?: S3CopyObjectOperation;
|
332 | |
333 |
|
334 |
|
335 | S3PutObjectAcl?: S3SetObjectAclOperation;
|
336 | |
337 |
|
338 |
|
339 | S3PutObjectTagging?: S3SetObjectTaggingOperation;
|
340 | |
341 |
|
342 |
|
343 | S3InitiateRestoreObject?: S3InitiateRestoreObjectOperation;
|
344 | }
|
345 | export type JobPriority = number;
|
346 | export interface JobProgressSummary {
|
347 | |
348 |
|
349 |
|
350 | TotalNumberOfTasks?: JobTotalNumberOfTasks;
|
351 | |
352 |
|
353 |
|
354 | NumberOfTasksSucceeded?: JobNumberOfTasksSucceeded;
|
355 | |
356 |
|
357 |
|
358 | NumberOfTasksFailed?: JobNumberOfTasksFailed;
|
359 | }
|
360 | export interface JobReport {
|
361 | |
362 |
|
363 |
|
364 | Bucket?: S3BucketArnString;
|
365 | |
366 |
|
367 |
|
368 | Format?: JobReportFormat;
|
369 | |
370 |
|
371 |
|
372 | Enabled: Boolean;
|
373 | |
374 |
|
375 |
|
376 | Prefix?: ReportPrefixString;
|
377 | |
378 |
|
379 |
|
380 | ReportScope?: JobReportScope;
|
381 | }
|
382 | export type JobReportFormat = "Report_CSV_20180820"|string;
|
383 | export type JobReportScope = "AllTasks"|"FailedTasksOnly"|string;
|
384 | export type JobStatus = "Active"|"Cancelled"|"Cancelling"|"Complete"|"Completing"|"Failed"|"Failing"|"New"|"Paused"|"Pausing"|"Preparing"|"Ready"|"Suspended"|string;
|
385 | export type JobStatusList = JobStatus[];
|
386 | export type JobStatusUpdateReason = string;
|
387 | export type JobTerminationDate = Date;
|
388 | export type JobTotalNumberOfTasks = number;
|
389 | export type KmsKeyArnString = string;
|
390 | export interface LambdaInvokeOperation {
|
391 | |
392 |
|
393 |
|
394 | FunctionArn?: NonEmptyMaxLength1024String;
|
395 | }
|
396 | export interface ListJobsRequest {
|
397 | |
398 |
|
399 |
|
400 | AccountId: AccountId;
|
401 | |
402 |
|
403 |
|
404 | JobStatuses?: JobStatusList;
|
405 | |
406 |
|
407 |
|
408 | NextToken?: NonEmptyMaxLength1024String;
|
409 | |
410 |
|
411 |
|
412 | MaxResults?: MaxResults;
|
413 | }
|
414 | export interface ListJobsResult {
|
415 | |
416 |
|
417 |
|
418 | NextToken?: NonEmptyMaxLength1024String;
|
419 | |
420 |
|
421 |
|
422 | Jobs?: JobListDescriptorList;
|
423 | }
|
424 | export type MaxLength1024String = string;
|
425 | export type MaxResults = number;
|
426 | export type NonEmptyMaxLength1024String = string;
|
427 | export type NonEmptyMaxLength2048String = string;
|
428 | export type NonEmptyMaxLength256String = string;
|
429 | export type NonEmptyMaxLength64String = string;
|
430 | export type OperationName = "LambdaInvoke"|"S3PutObjectCopy"|"S3PutObjectAcl"|"S3PutObjectTagging"|"S3InitiateRestoreObject"|string;
|
431 | export interface PublicAccessBlockConfiguration {
|
432 | |
433 |
|
434 |
|
435 | BlockPublicAcls?: Setting;
|
436 | |
437 |
|
438 |
|
439 | IgnorePublicAcls?: Setting;
|
440 | |
441 |
|
442 |
|
443 | BlockPublicPolicy?: Setting;
|
444 | |
445 |
|
446 |
|
447 | RestrictPublicBuckets?: Setting;
|
448 | }
|
449 | export interface PutPublicAccessBlockRequest {
|
450 | |
451 |
|
452 |
|
453 | PublicAccessBlockConfiguration: PublicAccessBlockConfiguration;
|
454 | |
455 |
|
456 |
|
457 | AccountId: AccountId;
|
458 | }
|
459 | export type ReportPrefixString = string;
|
460 | export type RequestedJobStatus = "Cancelled"|"Ready"|string;
|
461 | export interface S3AccessControlList {
|
462 | |
463 |
|
464 |
|
465 | Owner: S3ObjectOwner;
|
466 | |
467 |
|
468 |
|
469 | Grants?: S3GrantList;
|
470 | }
|
471 | export interface S3AccessControlPolicy {
|
472 | |
473 |
|
474 |
|
475 | AccessControlList?: S3AccessControlList;
|
476 | |
477 |
|
478 |
|
479 | CannedAccessControlList?: S3CannedAccessControlList;
|
480 | }
|
481 | export type S3BucketArnString = string;
|
482 | export type S3CannedAccessControlList = "private"|"public-read"|"public-read-write"|"aws-exec-read"|"authenticated-read"|"bucket-owner-read"|"bucket-owner-full-control"|string;
|
483 | export type S3ContentLength = number;
|
484 | export interface S3CopyObjectOperation {
|
485 | |
486 |
|
487 |
|
488 | TargetResource?: S3BucketArnString;
|
489 | |
490 |
|
491 |
|
492 | CannedAccessControlList?: S3CannedAccessControlList;
|
493 | |
494 |
|
495 |
|
496 | AccessControlGrants?: S3GrantList;
|
497 | |
498 |
|
499 |
|
500 | MetadataDirective?: S3MetadataDirective;
|
501 | |
502 |
|
503 |
|
504 | ModifiedSinceConstraint?: TimeStamp;
|
505 | |
506 |
|
507 |
|
508 | NewObjectMetadata?: S3ObjectMetadata;
|
509 | |
510 |
|
511 |
|
512 | NewObjectTagging?: S3TagSet;
|
513 | |
514 |
|
515 |
|
516 | RedirectLocation?: NonEmptyMaxLength2048String;
|
517 | |
518 |
|
519 |
|
520 | RequesterPays?: Boolean;
|
521 | |
522 |
|
523 |
|
524 | StorageClass?: S3StorageClass;
|
525 | |
526 |
|
527 |
|
528 | UnModifiedSinceConstraint?: TimeStamp;
|
529 | |
530 |
|
531 |
|
532 | SSEAwsKmsKeyId?: KmsKeyArnString;
|
533 | TargetKeyPrefix?: NonEmptyMaxLength1024String;
|
534 | ObjectLockLegalHoldStatus?: S3ObjectLockLegalHoldStatus;
|
535 | ObjectLockMode?: S3ObjectLockMode;
|
536 | ObjectLockRetainUntilDate?: TimeStamp;
|
537 | }
|
538 | export type S3ExpirationInDays = number;
|
539 | export type S3GlacierJobTier = "BULK"|"STANDARD"|string;
|
540 | export interface S3Grant {
|
541 | |
542 |
|
543 |
|
544 | Grantee?: S3Grantee;
|
545 | |
546 |
|
547 |
|
548 | Permission?: S3Permission;
|
549 | }
|
550 | export type S3GrantList = S3Grant[];
|
551 | export interface S3Grantee {
|
552 | |
553 |
|
554 |
|
555 | TypeIdentifier?: S3GranteeTypeIdentifier;
|
556 | |
557 |
|
558 |
|
559 | Identifier?: NonEmptyMaxLength1024String;
|
560 | |
561 |
|
562 |
|
563 | DisplayName?: NonEmptyMaxLength1024String;
|
564 | }
|
565 | export type S3GranteeTypeIdentifier = "id"|"emailAddress"|"uri"|string;
|
566 | export interface S3InitiateRestoreObjectOperation {
|
567 | |
568 |
|
569 |
|
570 | ExpirationInDays?: S3ExpirationInDays;
|
571 | |
572 |
|
573 |
|
574 | GlacierJobTier?: S3GlacierJobTier;
|
575 | }
|
576 | export type S3KeyArnString = string;
|
577 | export type S3MetadataDirective = "COPY"|"REPLACE"|string;
|
578 | export type S3ObjectLockLegalHoldStatus = "OFF"|"ON"|string;
|
579 | export type S3ObjectLockMode = "COMPLIANCE"|"GOVERNANCE"|string;
|
580 | export interface S3ObjectMetadata {
|
581 | |
582 |
|
583 |
|
584 | CacheControl?: NonEmptyMaxLength1024String;
|
585 | |
586 |
|
587 |
|
588 | ContentDisposition?: NonEmptyMaxLength1024String;
|
589 | |
590 |
|
591 |
|
592 | ContentEncoding?: NonEmptyMaxLength1024String;
|
593 | |
594 |
|
595 |
|
596 | ContentLanguage?: NonEmptyMaxLength1024String;
|
597 | |
598 |
|
599 |
|
600 | UserMetadata?: S3UserMetadata;
|
601 | |
602 |
|
603 |
|
604 | ContentLength?: S3ContentLength;
|
605 | |
606 |
|
607 |
|
608 | ContentMD5?: NonEmptyMaxLength1024String;
|
609 | |
610 |
|
611 |
|
612 | ContentType?: NonEmptyMaxLength1024String;
|
613 | |
614 |
|
615 |
|
616 | HttpExpiresDate?: TimeStamp;
|
617 | |
618 |
|
619 |
|
620 | RequesterCharged?: Boolean;
|
621 | |
622 |
|
623 |
|
624 | SSEAlgorithm?: S3SSEAlgorithm;
|
625 | }
|
626 | export interface S3ObjectOwner {
|
627 | |
628 |
|
629 |
|
630 | ID?: NonEmptyMaxLength1024String;
|
631 | |
632 |
|
633 |
|
634 | DisplayName?: NonEmptyMaxLength1024String;
|
635 | }
|
636 | export type S3ObjectVersionId = string;
|
637 | export type S3Permission = "FULL_CONTROL"|"READ"|"WRITE"|"READ_ACP"|"WRITE_ACP"|string;
|
638 | export type S3SSEAlgorithm = "AES256"|"KMS"|string;
|
639 | export interface S3SetObjectAclOperation {
|
640 | |
641 |
|
642 |
|
643 | AccessControlPolicy?: S3AccessControlPolicy;
|
644 | }
|
645 | export interface S3SetObjectTaggingOperation {
|
646 | |
647 |
|
648 |
|
649 | TagSet?: S3TagSet;
|
650 | }
|
651 | export type S3StorageClass = "STANDARD"|"STANDARD_IA"|"ONEZONE_IA"|"GLACIER"|"INTELLIGENT_TIERING"|"DEEP_ARCHIVE"|string;
|
652 | export interface S3Tag {
|
653 | |
654 |
|
655 |
|
656 | Key: NonEmptyMaxLength1024String;
|
657 | |
658 |
|
659 |
|
660 | Value: MaxLength1024String;
|
661 | }
|
662 | export type S3TagSet = S3Tag[];
|
663 | export type S3UserMetadata = {[key: string]: MaxLength1024String};
|
664 | export type Setting = boolean;
|
665 | export type SuspendedCause = string;
|
666 | export type SuspendedDate = Date;
|
667 | export type TimeStamp = Date;
|
668 | export interface UpdateJobPriorityRequest {
|
669 | |
670 |
|
671 |
|
672 | AccountId: AccountId;
|
673 | |
674 |
|
675 |
|
676 | JobId: JobId;
|
677 | |
678 |
|
679 |
|
680 | Priority: JobPriority;
|
681 | }
|
682 | export interface UpdateJobPriorityResult {
|
683 | |
684 |
|
685 |
|
686 | JobId: JobId;
|
687 | |
688 |
|
689 |
|
690 | Priority: JobPriority;
|
691 | }
|
692 | export interface UpdateJobStatusRequest {
|
693 | |
694 |
|
695 |
|
696 | AccountId: AccountId;
|
697 | |
698 |
|
699 |
|
700 | JobId: JobId;
|
701 | |
702 |
|
703 |
|
704 | RequestedJobStatus: RequestedJobStatus;
|
705 | |
706 |
|
707 |
|
708 | StatusUpdateReason?: JobStatusUpdateReason;
|
709 | }
|
710 | export interface UpdateJobStatusResult {
|
711 | |
712 |
|
713 |
|
714 | JobId?: JobId;
|
715 | |
716 |
|
717 |
|
718 | Status?: JobStatus;
|
719 | |
720 |
|
721 |
|
722 | StatusUpdateReason?: JobStatusUpdateReason;
|
723 | }
|
724 | |
725 |
|
726 |
|
727 | export type apiVersion = "2018-08-20"|"latest"|string;
|
728 | export interface ClientApiVersions {
|
729 | |
730 |
|
731 |
|
732 | apiVersion?: apiVersion;
|
733 | }
|
734 | export type ClientConfiguration = ServiceConfigurationOptions & UseDualstackConfigOptions & ClientApiVersions;
|
735 | |
736 |
|
737 |
|
738 | export import Types = S3Control;
|
739 | }
|
740 | export = S3Control;
|