@@ -97,7 +97,9 @@ service Controller {
97
97
returns (ControllerExpandVolumeResponse ) {}
98
98
99
99
rpc ControllerGetVolume (ControllerGetVolumeRequest )
100
- returns (ControllerGetVolumeResponse ) {}
100
+ returns (ControllerGetVolumeResponse ) {
101
+ option (alpha_method) = true ;
102
+ }
101
103
}
102
104
103
105
service Node {
@@ -882,7 +884,7 @@ message ListVolumesResponse {
882
884
// This field is OPTIONAL.
883
885
// This field MUST be specified if the
884
886
// VOLUME_CONDITION controller capability is supported.
885
- VolumeCondition volume_condition = 2 ;
887
+ VolumeCondition volume_condition = 2 [ (alpha_field) = true ] ;
886
888
}
887
889
888
890
message Entry {
@@ -906,12 +908,16 @@ message ListVolumesResponse {
906
908
string next_token = 2 ;
907
909
}
908
910
message ControllerGetVolumeRequest {
911
+ option (alpha_message) = true ;
912
+
909
913
// The ID of the volume to fetch current volume information for.
910
914
// This field is REQUIRED.
911
915
string volume_id = 1 ;
912
916
}
913
917
914
918
message ControllerGetVolumeResponse {
919
+ option (alpha_message) = true ;
920
+
915
921
message VolumeStatus {
916
922
// A list of all the `node_id` of nodes that this volume is
917
923
// controller published on.
@@ -1056,12 +1062,14 @@ message ControllerServiceCapability {
1056
1062
// If for some reason Controller and Node Plugins report
1057
1063
// misaligned volume conditions, CO SHALL assume the worst case
1058
1064
// is the truth.
1059
- VOLUME_CONDITION = 11 ;
1065
+ // Note that, for alpha, `VolumeCondition` is intended be
1066
+ // informative for humans only, not for automation.
1067
+ VOLUME_CONDITION = 11 [(alpha_enum_value) = true ];
1060
1068
1061
1069
// Indicates the SP supports the ControllerGetVolume RPC.
1062
1070
// This enables COs to, for example, fetch per volume
1063
1071
// condition after a volume is provisioned.
1064
- GET_VOLUME = 12 ;
1072
+ GET_VOLUME = 12 [ (alpha_enum_value) = true ] ;
1065
1073
1066
1074
// Indicates the SP supports the SINGLE_NODE_SINGLE_WRITER and/or
1067
1075
// SINGLE_NODE_MULTI_WRITER access modes.
@@ -1432,7 +1440,7 @@ message NodeGetVolumeStatsResponse {
1432
1440
// This field is OPTIONAL.
1433
1441
// This field MUST be specified if the VOLUME_CONDITION node
1434
1442
// capability is supported.
1435
- VolumeCondition volume_condition = 2 ;
1443
+ VolumeCondition volume_condition = 2 [ (alpha_field) = true ] ;
1436
1444
}
1437
1445
1438
1446
message VolumeUsage {
@@ -1459,6 +1467,8 @@ message VolumeUsage {
1459
1467
1460
1468
// VolumeCondition represents the current condition of a volume.
1461
1469
message VolumeCondition {
1470
+ option (alpha_message) = true ;
1471
+
1462
1472
// Normal volumes are available for use and operating optimally.
1463
1473
// An abnormal volume does not meet these criteria.
1464
1474
// This field is REQUIRED.
@@ -1499,7 +1509,9 @@ message NodeServiceCapability {
1499
1509
// If for some reason Node and Controller Plugins report
1500
1510
// misaligned volume conditions, CO SHALL assume the worst case
1501
1511
// is the truth.
1502
- VOLUME_CONDITION = 4 ;
1512
+ // Note that, for alpha, `VolumeCondition` is intended to be
1513
+ // informative for humans only, not for automation.
1514
+ VOLUME_CONDITION = 4 [(alpha_enum_value) = true ];
1503
1515
1504
1516
// Indicates the SP supports the SINGLE_NODE_SINGLE_WRITER and/or
1505
1517
// SINGLE_NODE_MULTI_WRITER access modes.
0 commit comments