Skip to content

Commit ea383cf

Browse files
feat(parallelstore): update the API
#### parallelstore:v1beta The following keys were added: - schemas.ExportDataRequest.properties.metadataOptions.$ref - schemas.ExportDataRequest.properties.metadataOptions.description - schemas.ImportDataRequest.properties.metadataOptions.$ref - schemas.ImportDataRequest.properties.metadataOptions.description - schemas.Instance.properties.daosVersion.deprecated - schemas.Instance.properties.daosVersion.description - schemas.Instance.properties.daosVersion.readOnly - schemas.Instance.properties.daosVersion.type - schemas.ReconciliationOperationMetadata.description - schemas.ReconciliationOperationMetadata.id - schemas.ReconciliationOperationMetadata.properties.deleteResource.deprecated - schemas.ReconciliationOperationMetadata.properties.deleteResource.description - schemas.ReconciliationOperationMetadata.properties.deleteResource.type - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.description - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.enum - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.enumDeprecated - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.enumDescriptions - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.type - schemas.ReconciliationOperationMetadata.type - schemas.TransferMetadataOptions.description - schemas.TransferMetadataOptions.id - schemas.TransferMetadataOptions.properties.gid.description - schemas.TransferMetadataOptions.properties.gid.enum - schemas.TransferMetadataOptions.properties.gid.enumDescriptions - schemas.TransferMetadataOptions.properties.gid.type - schemas.TransferMetadataOptions.properties.mode.description - schemas.TransferMetadataOptions.properties.mode.enum - schemas.TransferMetadataOptions.properties.mode.enumDescriptions - schemas.TransferMetadataOptions.properties.mode.type - schemas.TransferMetadataOptions.properties.uid.description - schemas.TransferMetadataOptions.properties.uid.enum - schemas.TransferMetadataOptions.properties.uid.enumDescriptions - schemas.TransferMetadataOptions.properties.uid.type - schemas.TransferMetadataOptions.type The following keys were changed: - schemas.Instance.properties.deploymentType.description - schemas.Instance.properties.directoryStripeLevel.description - schemas.Instance.properties.fileStripeLevel.description #### parallelstore:v1 The following keys were added: - schemas.ExportDataRequest.properties.metadataOptions.$ref - schemas.ExportDataRequest.properties.metadataOptions.description - schemas.ImportDataRequest.properties.metadataOptions.$ref - schemas.ImportDataRequest.properties.metadataOptions.description - schemas.Instance.properties.daosVersion.deprecated - schemas.Instance.properties.daosVersion.description - schemas.Instance.properties.daosVersion.readOnly - schemas.Instance.properties.daosVersion.type - schemas.ReconciliationOperationMetadata.description - schemas.ReconciliationOperationMetadata.id - schemas.ReconciliationOperationMetadata.properties.deleteResource.deprecated - schemas.ReconciliationOperationMetadata.properties.deleteResource.description - schemas.ReconciliationOperationMetadata.properties.deleteResource.type - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.description - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.enum - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.enumDeprecated - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.enumDescriptions - schemas.ReconciliationOperationMetadata.properties.exclusiveAction.type - schemas.ReconciliationOperationMetadata.type - schemas.TransferMetadataOptions.description - schemas.TransferMetadataOptions.id - schemas.TransferMetadataOptions.properties.gid.description - schemas.TransferMetadataOptions.properties.gid.enum - schemas.TransferMetadataOptions.properties.gid.enumDescriptions - schemas.TransferMetadataOptions.properties.gid.type - schemas.TransferMetadataOptions.properties.mode.description - schemas.TransferMetadataOptions.properties.mode.enum - schemas.TransferMetadataOptions.properties.mode.enumDescriptions - schemas.TransferMetadataOptions.properties.mode.type - schemas.TransferMetadataOptions.properties.uid.description - schemas.TransferMetadataOptions.properties.uid.enum - schemas.TransferMetadataOptions.properties.uid.enumDescriptions - schemas.TransferMetadataOptions.properties.uid.type - schemas.TransferMetadataOptions.type The following keys were changed: - schemas.Instance.properties.deploymentType.description - schemas.Instance.properties.directoryStripeLevel.description - schemas.Instance.properties.fileStripeLevel.description
1 parent e82e5c6 commit ea383cf

File tree

4 files changed

+286
-14
lines changed

4 files changed

+286
-14
lines changed

discovery/parallelstore-v1.json

Lines changed: 98 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -543,7 +543,7 @@
543543
}
544544
}
545545
},
546-
"revision": "20250102",
546+
"revision": "20250303",
547547
"rootUrl": "https://parallelstore.googleapis.com/",
548548
"schemas": {
549549
"CancelOperationRequest": {
@@ -582,6 +582,10 @@
582582
"$ref": "DestinationGcsBucket",
583583
"description": "Cloud Storage destination."
584584
},
585+
"metadataOptions": {
586+
"$ref": "TransferMetadataOptions",
587+
"description": "Optional. The metadata options for the export data."
588+
},
585589
"requestId": {
586590
"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
587591
"type": "string"
@@ -611,6 +615,10 @@
611615
"$ref": "DestinationParallelstore",
612616
"description": "Parallelstore destination."
613617
},
618+
"metadataOptions": {
619+
"$ref": "TransferMetadataOptions",
620+
"description": "Optional. The transfer metadata options for the import data."
621+
},
614622
"requestId": {
615623
"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
616624
"type": "string"
@@ -649,8 +657,14 @@
649657
"readOnly": true,
650658
"type": "string"
651659
},
660+
"daosVersion": {
661+
"deprecated": true,
662+
"description": "Output only. Deprecated 'daos_version' field. Output only. The version of DAOS software running in the instance.",
663+
"readOnly": true,
664+
"type": "string"
665+
},
652666
"deploymentType": {
653-
"description": "Optional. The deployment type of the instance. Allowed values are: * `SCRATCH`: the instance is a scratch instance. * `PERSISTENT`: the instance is a persistent instance.",
667+
"description": "Optional. Immutable. The deployment type of the instance. Allowed values are: * `SCRATCH`: the instance is a scratch instance. * `PERSISTENT`: the instance is a persistent instance.",
654668
"enum": [
655669
"DEPLOYMENT_TYPE_UNSPECIFIED",
656670
"SCRATCH",
@@ -668,7 +682,7 @@
668682
"type": "string"
669683
},
670684
"directoryStripeLevel": {
671-
"description": "Optional. Stripe level for directories. Allowed values are: * `DIRECTORY_STRIPE_LEVEL_MIN`: recommended when directories contain a small number of files. * `DIRECTORY_STRIPE_LEVEL_BALANCED`: balances performance for workloads involving a mix of small and large directories. * `DIRECTORY_STRIPE_LEVEL_MAX`: recommended for directories with a large number of files.",
685+
"description": "Optional. Immutable. Stripe level for directories. Allowed values are: * `DIRECTORY_STRIPE_LEVEL_MIN`: recommended when directories contain a small number of files. * `DIRECTORY_STRIPE_LEVEL_BALANCED`: balances performance for workloads involving a mix of small and large directories. * `DIRECTORY_STRIPE_LEVEL_MAX`: recommended for directories with a large number of files.",
672686
"enum": [
673687
"DIRECTORY_STRIPE_LEVEL_UNSPECIFIED",
674688
"DIRECTORY_STRIPE_LEVEL_MIN",
@@ -689,7 +703,7 @@
689703
"type": "string"
690704
},
691705
"fileStripeLevel": {
692-
"description": "Optional. Stripe level for files. Allowed values are: * `FILE_STRIPE_LEVEL_MIN`: offers the best performance for small size files. * `FILE_STRIPE_LEVEL_BALANCED`: balances performance for workloads involving a mix of small and large files. * `FILE_STRIPE_LEVEL_MAX`: higher throughput performance for larger files.",
706+
"description": "Optional. Immutable. Stripe level for files. Allowed values are: * `FILE_STRIPE_LEVEL_MIN`: offers the best performance for small size files. * `FILE_STRIPE_LEVEL_BALANCED`: balances performance for workloads involving a mix of small and large files. * `FILE_STRIPE_LEVEL_MAX`: higher throughput performance for larger files.",
693707
"enum": [
694708
"FILE_STRIPE_LEVEL_UNSPECIFIED",
695709
"FILE_STRIPE_LEVEL_MIN",
@@ -929,6 +943,37 @@
929943
},
930944
"type": "object"
931945
},
946+
"ReconciliationOperationMetadata": {
947+
"description": "Operation metadata returned by the CLH during resource state reconciliation.",
948+
"id": "ReconciliationOperationMetadata",
949+
"properties": {
950+
"deleteResource": {
951+
"deprecated": true,
952+
"description": "DEPRECATED. Use exclusive_action instead.",
953+
"type": "boolean"
954+
},
955+
"exclusiveAction": {
956+
"description": "Excluisive action returned by the CLH.",
957+
"enum": [
958+
"UNKNOWN_REPAIR_ACTION",
959+
"DELETE",
960+
"RETRY"
961+
],
962+
"enumDeprecated": [
963+
false,
964+
true,
965+
false
966+
],
967+
"enumDescriptions": [
968+
"Unknown repair action.",
969+
"The resource has to be deleted. When using this bit, the CLH should fail the operation. DEPRECATED. Instead use DELETE_RESOURCE OperationSignal in SideChannel.",
970+
"This resource could not be repaired but the repair should be tried again at a later time. This can happen if there is a dependency that needs to be resolved first- e.g. if a parent resource must be repaired before a child resource."
971+
],
972+
"type": "string"
973+
}
974+
},
975+
"type": "object"
976+
},
932977
"SourceGcsBucket": {
933978
"description": "Cloud Storage as the source of a data transfer.",
934979
"id": "SourceGcsBucket",
@@ -977,6 +1022,55 @@
9771022
}
9781023
},
9791024
"type": "object"
1025+
},
1026+
"TransferMetadataOptions": {
1027+
"description": "Transfer metadata options for the instance.",
1028+
"id": "TransferMetadataOptions",
1029+
"properties": {
1030+
"gid": {
1031+
"description": "Optional. The GID preservation behavior.",
1032+
"enum": [
1033+
"GID_UNSPECIFIED",
1034+
"GID_SKIP",
1035+
"GID_NUMBER_PRESERVE"
1036+
],
1037+
"enumDescriptions": [
1038+
"default is GID_NUMBER_PRESERVE.",
1039+
"Do not preserve GID during a transfer job.",
1040+
"Preserve GID that is in number format during a transfer job."
1041+
],
1042+
"type": "string"
1043+
},
1044+
"mode": {
1045+
"description": "Optional. The mode preservation behavior.",
1046+
"enum": [
1047+
"MODE_UNSPECIFIED",
1048+
"MODE_SKIP",
1049+
"MODE_PRESERVE"
1050+
],
1051+
"enumDescriptions": [
1052+
"default is MODE_PRESERVE.",
1053+
"Do not preserve mode during a transfer job.",
1054+
"Preserve mode during a transfer job."
1055+
],
1056+
"type": "string"
1057+
},
1058+
"uid": {
1059+
"description": "Optional. The UID preservation behavior.",
1060+
"enum": [
1061+
"UID_UNSPECIFIED",
1062+
"UID_SKIP",
1063+
"UID_NUMBER_PRESERVE"
1064+
],
1065+
"enumDescriptions": [
1066+
"default is UID_NUMBER_PRESERVE.",
1067+
"Do not preserve UID during a transfer job.",
1068+
"Preserve UID that is in number format during a transfer job."
1069+
],
1070+
"type": "string"
1071+
}
1072+
},
1073+
"type": "object"
9801074
}
9811075
},
9821076
"servicePath": "",

discovery/parallelstore-v1beta.json

Lines changed: 98 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -540,7 +540,7 @@
540540
}
541541
}
542542
},
543-
"revision": "20250102",
543+
"revision": "20250303",
544544
"rootUrl": "https://parallelstore.googleapis.com/",
545545
"schemas": {
546546
"DestinationGcsBucket": {
@@ -573,6 +573,10 @@
573573
"$ref": "DestinationGcsBucket",
574574
"description": "Cloud Storage destination."
575575
},
576+
"metadataOptions": {
577+
"$ref": "TransferMetadataOptions",
578+
"description": "Optional. The metadata options for the export data."
579+
},
576580
"requestId": {
577581
"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
578582
"type": "string"
@@ -602,6 +606,10 @@
602606
"$ref": "DestinationParallelstore",
603607
"description": "Parallelstore destination."
604608
},
609+
"metadataOptions": {
610+
"$ref": "TransferMetadataOptions",
611+
"description": "Optional. The transfer metadata options for the import data."
612+
},
605613
"requestId": {
606614
"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
607615
"type": "string"
@@ -640,8 +648,14 @@
640648
"readOnly": true,
641649
"type": "string"
642650
},
651+
"daosVersion": {
652+
"deprecated": true,
653+
"description": "Output only. Deprecated 'daos_version' field. Output only. The version of DAOS software running in the instance.",
654+
"readOnly": true,
655+
"type": "string"
656+
},
643657
"deploymentType": {
644-
"description": "Optional. The deployment type of the instance. Allowed values are: * `SCRATCH`: the instance is a scratch instance. * `PERSISTENT`: the instance is a persistent instance.",
658+
"description": "Optional. Immutable. The deployment type of the instance. Allowed values are: * `SCRATCH`: the instance is a scratch instance. * `PERSISTENT`: the instance is a persistent instance.",
645659
"enum": [
646660
"DEPLOYMENT_TYPE_UNSPECIFIED",
647661
"SCRATCH",
@@ -659,7 +673,7 @@
659673
"type": "string"
660674
},
661675
"directoryStripeLevel": {
662-
"description": "Optional. Stripe level for directories. Allowed values are: * `DIRECTORY_STRIPE_LEVEL_MIN`: recommended when directories contain a small number of files. * `DIRECTORY_STRIPE_LEVEL_BALANCED`: balances performance for workloads involving a mix of small and large directories. * `DIRECTORY_STRIPE_LEVEL_MAX`: recommended for directories with a large number of files.",
676+
"description": "Optional. Immutable. Stripe level for directories. Allowed values are: * `DIRECTORY_STRIPE_LEVEL_MIN`: recommended when directories contain a small number of files. * `DIRECTORY_STRIPE_LEVEL_BALANCED`: balances performance for workloads involving a mix of small and large directories. * `DIRECTORY_STRIPE_LEVEL_MAX`: recommended for directories with a large number of files.",
663677
"enum": [
664678
"DIRECTORY_STRIPE_LEVEL_UNSPECIFIED",
665679
"DIRECTORY_STRIPE_LEVEL_MIN",
@@ -680,7 +694,7 @@
680694
"type": "string"
681695
},
682696
"fileStripeLevel": {
683-
"description": "Optional. Stripe level for files. Allowed values are: * `FILE_STRIPE_LEVEL_MIN`: offers the best performance for small size files. * `FILE_STRIPE_LEVEL_BALANCED`: balances performance for workloads involving a mix of small and large files. * `FILE_STRIPE_LEVEL_MAX`: higher throughput performance for larger files.",
697+
"description": "Optional. Immutable. Stripe level for files. Allowed values are: * `FILE_STRIPE_LEVEL_MIN`: offers the best performance for small size files. * `FILE_STRIPE_LEVEL_BALANCED`: balances performance for workloads involving a mix of small and large files. * `FILE_STRIPE_LEVEL_MAX`: higher throughput performance for larger files.",
684698
"enum": [
685699
"FILE_STRIPE_LEVEL_UNSPECIFIED",
686700
"FILE_STRIPE_LEVEL_MIN",
@@ -920,6 +934,37 @@
920934
},
921935
"type": "object"
922936
},
937+
"ReconciliationOperationMetadata": {
938+
"description": "Operation metadata returned by the CLH during resource state reconciliation.",
939+
"id": "ReconciliationOperationMetadata",
940+
"properties": {
941+
"deleteResource": {
942+
"deprecated": true,
943+
"description": "DEPRECATED. Use exclusive_action instead.",
944+
"type": "boolean"
945+
},
946+
"exclusiveAction": {
947+
"description": "Excluisive action returned by the CLH.",
948+
"enum": [
949+
"UNKNOWN_REPAIR_ACTION",
950+
"DELETE",
951+
"RETRY"
952+
],
953+
"enumDeprecated": [
954+
false,
955+
true,
956+
false
957+
],
958+
"enumDescriptions": [
959+
"Unknown repair action.",
960+
"The resource has to be deleted. When using this bit, the CLH should fail the operation. DEPRECATED. Instead use DELETE_RESOURCE OperationSignal in SideChannel.",
961+
"This resource could not be repaired but the repair should be tried again at a later time. This can happen if there is a dependency that needs to be resolved first- e.g. if a parent resource must be repaired before a child resource."
962+
],
963+
"type": "string"
964+
}
965+
},
966+
"type": "object"
967+
},
923968
"SourceGcsBucket": {
924969
"description": "Cloud Storage as the source of a data transfer.",
925970
"id": "SourceGcsBucket",
@@ -968,6 +1013,55 @@
9681013
}
9691014
},
9701015
"type": "object"
1016+
},
1017+
"TransferMetadataOptions": {
1018+
"description": "Transfer metadata options for the instance.",
1019+
"id": "TransferMetadataOptions",
1020+
"properties": {
1021+
"gid": {
1022+
"description": "Optional. The GID preservation behavior.",
1023+
"enum": [
1024+
"GID_UNSPECIFIED",
1025+
"GID_SKIP",
1026+
"GID_NUMBER_PRESERVE"
1027+
],
1028+
"enumDescriptions": [
1029+
"default is GID_NUMBER_PRESERVE.",
1030+
"Do not preserve GID during a transfer job.",
1031+
"Preserve GID that is in number format during a transfer job."
1032+
],
1033+
"type": "string"
1034+
},
1035+
"mode": {
1036+
"description": "Optional. The mode preservation behavior.",
1037+
"enum": [
1038+
"MODE_UNSPECIFIED",
1039+
"MODE_SKIP",
1040+
"MODE_PRESERVE"
1041+
],
1042+
"enumDescriptions": [
1043+
"default is MODE_PRESERVE.",
1044+
"Do not preserve mode during a transfer job.",
1045+
"Preserve mode during a transfer job."
1046+
],
1047+
"type": "string"
1048+
},
1049+
"uid": {
1050+
"description": "Optional. The UID preservation behavior.",
1051+
"enum": [
1052+
"UID_UNSPECIFIED",
1053+
"UID_SKIP",
1054+
"UID_NUMBER_PRESERVE"
1055+
],
1056+
"enumDescriptions": [
1057+
"default is UID_NUMBER_PRESERVE.",
1058+
"Do not preserve UID during a transfer job.",
1059+
"Preserve UID that is in number format during a transfer job."
1060+
],
1061+
"type": "string"
1062+
}
1063+
},
1064+
"type": "object"
9711065
}
9721066
},
9731067
"servicePath": "",

0 commit comments

Comments
 (0)