aws-sdk-opensearchserverless 1.45.0 → 1.46.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-opensearchserverless/client.rb +6 -4
- data/lib/aws-sdk-opensearchserverless/client_api.rb +20 -14
- data/lib/aws-sdk-opensearchserverless/types.rb +38 -1
- data/lib/aws-sdk-opensearchserverless.rb +1 -1
- data/sig/types.rbs +7 -0
- metadata +1 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 7e1ea9a0dff69a9a6302954c49a2d5d6c9aa9c10e41fe3a4f799dad68efdef76
|
4
|
+
data.tar.gz: fa54e8aff246deebd45afce5c64b3ea38a820169428ed0ab7d59d0550180cf0b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 19c25a6297ae3d2e507a782e472304417f3d08db9d6275f0d6fe1cb3ce6c66f4621c6fdb0991480f8210207c0c23107e4cd4a235a6f7495787ed6ad6677e1d3f
|
7
|
+
data.tar.gz: e86cae9da252b5f60e75dc98e29b85cfae2e4997c3c9043293aa3c977bb069fbc15e89d4964c7e35f30cea57959f49e40bcedf4a196a9b59aac4b297beff3791
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,11 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.46.0 (2025-09-04)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Add support for Federal Information Processing Standards (FIPS) and Federal Risk and Authorization Management Program (FedRAMP) compliance
|
8
|
+
|
4
9
|
1.45.0 (2025-08-26)
|
5
10
|
------------------
|
6
11
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.46.0
|
@@ -484,9 +484,9 @@ module Aws::OpenSearchServerless
|
|
484
484
|
# @!group API Operations
|
485
485
|
|
486
486
|
# Returns attributes for one or more collections, including the
|
487
|
-
# collection endpoint
|
488
|
-
# information, see [Creating and
|
489
|
-
# collections][1].
|
487
|
+
# collection endpoint, the OpenSearch Dashboards endpoint, and
|
488
|
+
# FIPS-compliant endpoints. For more information, see [Creating and
|
489
|
+
# managing Amazon OpenSearch Serverless collections][1].
|
490
490
|
#
|
491
491
|
#
|
492
492
|
#
|
@@ -532,6 +532,8 @@ module Aws::OpenSearchServerless
|
|
532
532
|
# resp.collection_details[0].last_modified_date #=> Integer
|
533
533
|
# resp.collection_details[0].collection_endpoint #=> String
|
534
534
|
# resp.collection_details[0].dashboard_endpoint #=> String
|
535
|
+
# resp.collection_details[0].fips_endpoints.collection_endpoint #=> String
|
536
|
+
# resp.collection_details[0].fips_endpoints.dashboard_endpoint #=> String
|
535
537
|
# resp.collection_details[0].failure_code #=> String
|
536
538
|
# resp.collection_details[0].failure_message #=> String
|
537
539
|
# resp.collection_error_details #=> Array
|
@@ -2645,7 +2647,7 @@ module Aws::OpenSearchServerless
|
|
2645
2647
|
tracer: tracer
|
2646
2648
|
)
|
2647
2649
|
context[:gem_name] = 'aws-sdk-opensearchserverless'
|
2648
|
-
context[:gem_version] = '1.
|
2650
|
+
context[:gem_version] = '1.46.0'
|
2649
2651
|
Seahorse::Client::Request.new(handlers, context)
|
2650
2652
|
end
|
2651
2653
|
|
@@ -87,6 +87,7 @@ module Aws::OpenSearchServerless
|
|
87
87
|
EffectiveLifecyclePolicyDetails = Shapes::ListShape.new(name: 'EffectiveLifecyclePolicyDetails')
|
88
88
|
EffectiveLifecyclePolicyErrorDetail = Shapes::StructureShape.new(name: 'EffectiveLifecyclePolicyErrorDetail')
|
89
89
|
EffectiveLifecyclePolicyErrorDetails = Shapes::ListShape.new(name: 'EffectiveLifecyclePolicyErrorDetails')
|
90
|
+
FipsEndpoints = Shapes::StructureShape.new(name: 'FipsEndpoints')
|
90
91
|
GetAccessPolicyRequest = Shapes::StructureShape.new(name: 'GetAccessPolicyRequest')
|
91
92
|
GetAccessPolicyResponse = Shapes::StructureShape.new(name: 'GetAccessPolicyResponse')
|
92
93
|
GetAccountSettingsRequest = Shapes::StructureShape.new(name: 'GetAccountSettingsRequest')
|
@@ -295,6 +296,7 @@ module Aws::OpenSearchServerless
|
|
295
296
|
CollectionDetail.add_member(:last_modified_date, Shapes::ShapeRef.new(shape: Long, location_name: "lastModifiedDate"))
|
296
297
|
CollectionDetail.add_member(:collection_endpoint, Shapes::ShapeRef.new(shape: String, location_name: "collectionEndpoint"))
|
297
298
|
CollectionDetail.add_member(:dashboard_endpoint, Shapes::ShapeRef.new(shape: String, location_name: "dashboardEndpoint"))
|
299
|
+
CollectionDetail.add_member(:fips_endpoints, Shapes::ShapeRef.new(shape: FipsEndpoints, location_name: "fipsEndpoints"))
|
298
300
|
CollectionDetail.add_member(:failure_code, Shapes::ShapeRef.new(shape: String, location_name: "failureCode"))
|
299
301
|
CollectionDetail.add_member(:failure_message, Shapes::ShapeRef.new(shape: String, location_name: "failureMessage"))
|
300
302
|
CollectionDetail.struct_class = Types::CollectionDetail
|
@@ -495,6 +497,10 @@ module Aws::OpenSearchServerless
|
|
495
497
|
|
496
498
|
EffectiveLifecyclePolicyErrorDetails.member = Shapes::ShapeRef.new(shape: EffectiveLifecyclePolicyErrorDetail)
|
497
499
|
|
500
|
+
FipsEndpoints.add_member(:collection_endpoint, Shapes::ShapeRef.new(shape: String, location_name: "collectionEndpoint"))
|
501
|
+
FipsEndpoints.add_member(:dashboard_endpoint, Shapes::ShapeRef.new(shape: String, location_name: "dashboardEndpoint"))
|
502
|
+
FipsEndpoints.struct_class = Types::FipsEndpoints
|
503
|
+
|
498
504
|
GetAccessPolicyRequest.add_member(:type, Shapes::ShapeRef.new(shape: AccessPolicyType, required: true, location_name: "type"))
|
499
505
|
GetAccessPolicyRequest.add_member(:name, Shapes::ShapeRef.new(shape: PolicyName, required: true, location_name: "name"))
|
500
506
|
GetAccessPolicyRequest.struct_class = Types::GetAccessPolicyRequest
|
@@ -968,8 +974,8 @@ module Aws::OpenSearchServerless
|
|
968
974
|
o.http_request_uri = "/"
|
969
975
|
o.input = Shapes::ShapeRef.new(shape: CreateCollectionRequest)
|
970
976
|
o.output = Shapes::ShapeRef.new(shape: CreateCollectionResponse)
|
971
|
-
o.errors << Shapes::ShapeRef.new(shape: OcuLimitExceededException)
|
972
977
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
978
|
+
o.errors << Shapes::ShapeRef.new(shape: OcuLimitExceededException)
|
973
979
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
974
980
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
975
981
|
o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
|
@@ -982,8 +988,8 @@ module Aws::OpenSearchServerless
|
|
982
988
|
o.input = Shapes::ShapeRef.new(shape: CreateIndexRequest)
|
983
989
|
o.output = Shapes::ShapeRef.new(shape: CreateIndexResponse)
|
984
990
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
985
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
986
991
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
992
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
987
993
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
988
994
|
end)
|
989
995
|
|
@@ -1042,8 +1048,8 @@ module Aws::OpenSearchServerless
|
|
1042
1048
|
o.input = Shapes::ShapeRef.new(shape: DeleteAccessPolicyRequest)
|
1043
1049
|
o.output = Shapes::ShapeRef.new(shape: DeleteAccessPolicyResponse)
|
1044
1050
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1045
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1046
1051
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1052
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1047
1053
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1048
1054
|
end)
|
1049
1055
|
|
@@ -1054,8 +1060,8 @@ module Aws::OpenSearchServerless
|
|
1054
1060
|
o.input = Shapes::ShapeRef.new(shape: DeleteCollectionRequest)
|
1055
1061
|
o.output = Shapes::ShapeRef.new(shape: DeleteCollectionResponse)
|
1056
1062
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1057
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1058
1063
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1064
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1059
1065
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1060
1066
|
end)
|
1061
1067
|
|
@@ -1077,8 +1083,8 @@ module Aws::OpenSearchServerless
|
|
1077
1083
|
o.input = Shapes::ShapeRef.new(shape: DeleteLifecyclePolicyRequest)
|
1078
1084
|
o.output = Shapes::ShapeRef.new(shape: DeleteLifecyclePolicyResponse)
|
1079
1085
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1080
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1081
1086
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1087
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1082
1088
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1083
1089
|
end)
|
1084
1090
|
|
@@ -1089,8 +1095,8 @@ module Aws::OpenSearchServerless
|
|
1089
1095
|
o.input = Shapes::ShapeRef.new(shape: DeleteSecurityConfigRequest)
|
1090
1096
|
o.output = Shapes::ShapeRef.new(shape: DeleteSecurityConfigResponse)
|
1091
1097
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1092
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1093
1098
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1099
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1094
1100
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1095
1101
|
end)
|
1096
1102
|
|
@@ -1101,8 +1107,8 @@ module Aws::OpenSearchServerless
|
|
1101
1107
|
o.input = Shapes::ShapeRef.new(shape: DeleteSecurityPolicyRequest)
|
1102
1108
|
o.output = Shapes::ShapeRef.new(shape: DeleteSecurityPolicyResponse)
|
1103
1109
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1104
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1105
1110
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1111
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1106
1112
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1107
1113
|
end)
|
1108
1114
|
|
@@ -1113,8 +1119,8 @@ module Aws::OpenSearchServerless
|
|
1113
1119
|
o.input = Shapes::ShapeRef.new(shape: DeleteVpcEndpointRequest)
|
1114
1120
|
o.output = Shapes::ShapeRef.new(shape: DeleteVpcEndpointResponse)
|
1115
1121
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1116
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1117
1122
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1123
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1118
1124
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1119
1125
|
end)
|
1120
1126
|
|
@@ -1295,8 +1301,8 @@ module Aws::OpenSearchServerless
|
|
1295
1301
|
o.input = Shapes::ShapeRef.new(shape: TagResourceRequest)
|
1296
1302
|
o.output = Shapes::ShapeRef.new(shape: TagResourceResponse)
|
1297
1303
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1298
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1299
1304
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1305
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1300
1306
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1301
1307
|
o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
|
1302
1308
|
end)
|
@@ -1308,8 +1314,8 @@ module Aws::OpenSearchServerless
|
|
1308
1314
|
o.input = Shapes::ShapeRef.new(shape: UntagResourceRequest)
|
1309
1315
|
o.output = Shapes::ShapeRef.new(shape: UntagResourceResponse)
|
1310
1316
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1311
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1312
1317
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1318
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1313
1319
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1314
1320
|
end)
|
1315
1321
|
|
@@ -1320,8 +1326,8 @@ module Aws::OpenSearchServerless
|
|
1320
1326
|
o.input = Shapes::ShapeRef.new(shape: UpdateAccessPolicyRequest)
|
1321
1327
|
o.output = Shapes::ShapeRef.new(shape: UpdateAccessPolicyResponse)
|
1322
1328
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1323
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1324
1329
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1330
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1325
1331
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1326
1332
|
end)
|
1327
1333
|
|
@@ -1364,8 +1370,8 @@ module Aws::OpenSearchServerless
|
|
1364
1370
|
o.input = Shapes::ShapeRef.new(shape: UpdateLifecyclePolicyRequest)
|
1365
1371
|
o.output = Shapes::ShapeRef.new(shape: UpdateLifecyclePolicyResponse)
|
1366
1372
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1367
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1368
1373
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1374
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1369
1375
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1370
1376
|
o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
|
1371
1377
|
end)
|
@@ -1377,8 +1383,8 @@ module Aws::OpenSearchServerless
|
|
1377
1383
|
o.input = Shapes::ShapeRef.new(shape: UpdateSecurityConfigRequest)
|
1378
1384
|
o.output = Shapes::ShapeRef.new(shape: UpdateSecurityConfigResponse)
|
1379
1385
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1380
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1381
1386
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1387
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1382
1388
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1383
1389
|
end)
|
1384
1390
|
|
@@ -1389,8 +1395,8 @@ module Aws::OpenSearchServerless
|
|
1389
1395
|
o.input = Shapes::ShapeRef.new(shape: UpdateSecurityPolicyRequest)
|
1390
1396
|
o.output = Shapes::ShapeRef.new(shape: UpdateSecurityPolicyResponse)
|
1391
1397
|
o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
|
1392
|
-
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1393
1398
|
o.errors << Shapes::ShapeRef.new(shape: ConflictException)
|
1399
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
1394
1400
|
o.errors << Shapes::ShapeRef.new(shape: ValidationException)
|
1395
1401
|
o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
|
1396
1402
|
end)
|
@@ -288,7 +288,8 @@ module Aws::OpenSearchServerless
|
|
288
288
|
end
|
289
289
|
|
290
290
|
# Details about each OpenSearch Serverless collection, including the
|
291
|
-
# collection endpoint
|
291
|
+
# collection endpoint, the OpenSearch Dashboards endpoint, and
|
292
|
+
# FIPS-compliant endpoints for federal government workloads.
|
292
293
|
#
|
293
294
|
# @!attribute [rw] id
|
294
295
|
# A unique identifier for the collection.
|
@@ -340,6 +341,13 @@ module Aws::OpenSearchServerless
|
|
340
341
|
# Collection-specific endpoint used to access OpenSearch Dashboards.
|
341
342
|
# @return [String]
|
342
343
|
#
|
344
|
+
# @!attribute [rw] fips_endpoints
|
345
|
+
# FIPS-compliant endpoints for the collection. These endpoints use
|
346
|
+
# FIPS 140-3 validated cryptographic modules and are required for
|
347
|
+
# federal government workloads that must comply with FedRAMP security
|
348
|
+
# standards.
|
349
|
+
# @return [Types::FipsEndpoints]
|
350
|
+
#
|
343
351
|
# @!attribute [rw] failure_code
|
344
352
|
# A failure code associated with the request.
|
345
353
|
# @return [String]
|
@@ -363,6 +371,7 @@ module Aws::OpenSearchServerless
|
|
363
371
|
:last_modified_date,
|
364
372
|
:collection_endpoint,
|
365
373
|
:dashboard_endpoint,
|
374
|
+
:fips_endpoints,
|
366
375
|
:failure_code,
|
367
376
|
:failure_message)
|
368
377
|
SENSITIVE = []
|
@@ -1260,6 +1269,34 @@ module Aws::OpenSearchServerless
|
|
1260
1269
|
include Aws::Structure
|
1261
1270
|
end
|
1262
1271
|
|
1272
|
+
# FIPS-compliant endpoint URLs for an OpenSearch Serverless collection.
|
1273
|
+
# These endpoints ensure all data transmission uses FIPS 140-3 validated
|
1274
|
+
# cryptographic implementations, meeting federal security requirements
|
1275
|
+
# for government workloads.
|
1276
|
+
#
|
1277
|
+
# @!attribute [rw] collection_endpoint
|
1278
|
+
# FIPS-compliant collection endpoint used to submit index, search, and
|
1279
|
+
# data upload requests to an OpenSearch Serverless collection. This
|
1280
|
+
# endpoint uses FIPS 140-3 validated cryptography and is required for
|
1281
|
+
# federal government workloads.
|
1282
|
+
# @return [String]
|
1283
|
+
#
|
1284
|
+
# @!attribute [rw] dashboard_endpoint
|
1285
|
+
# FIPS-compliant endpoint used to access OpenSearch Dashboards. This
|
1286
|
+
# endpoint uses FIPS 140-3 validated cryptography and is required for
|
1287
|
+
# federal government workloads that need dashboard visualization
|
1288
|
+
# capabilities.
|
1289
|
+
# @return [String]
|
1290
|
+
#
|
1291
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/opensearchserverless-2021-11-01/FipsEndpoints AWS API Documentation
|
1292
|
+
#
|
1293
|
+
class FipsEndpoints < Struct.new(
|
1294
|
+
:collection_endpoint,
|
1295
|
+
:dashboard_endpoint)
|
1296
|
+
SENSITIVE = []
|
1297
|
+
include Aws::Structure
|
1298
|
+
end
|
1299
|
+
|
1263
1300
|
# @!attribute [rw] type
|
1264
1301
|
# Tye type of policy. Currently, the only supported value is `data`.
|
1265
1302
|
# @return [String]
|
data/sig/types.rbs
CHANGED
@@ -103,6 +103,7 @@ module Aws::OpenSearchServerless
|
|
103
103
|
attr_accessor last_modified_date: ::Integer
|
104
104
|
attr_accessor collection_endpoint: ::String
|
105
105
|
attr_accessor dashboard_endpoint: ::String
|
106
|
+
attr_accessor fips_endpoints: Types::FipsEndpoints
|
106
107
|
attr_accessor failure_code: ::String
|
107
108
|
attr_accessor failure_message: ::String
|
108
109
|
SENSITIVE: []
|
@@ -362,6 +363,12 @@ module Aws::OpenSearchServerless
|
|
362
363
|
SENSITIVE: []
|
363
364
|
end
|
364
365
|
|
366
|
+
class FipsEndpoints
|
367
|
+
attr_accessor collection_endpoint: ::String
|
368
|
+
attr_accessor dashboard_endpoint: ::String
|
369
|
+
SENSITIVE: []
|
370
|
+
end
|
371
|
+
|
365
372
|
class GetAccessPolicyRequest
|
366
373
|
attr_accessor type: ("data")
|
367
374
|
attr_accessor name: ::String
|